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ABSTRACT 


Special  Forces  are  crucial  in  specific  military  operations.  They  usually  operate  in 
hostile  territory  where  communications  are  difficult  to  establish  and  preserve,  since  the 
operations  are  often  carried  out  in  a  remote  environment  and  the  communications  need  to 
be  highly  mobile.  The  delivery  of  information  about  the  geographical  parameters  of  the 
area  can  be  crucial  for  the  completion  of  their  mission.  But  in  that  highly  mobile 
environment,  the  connectivity  of  the  established  wireless  networks  (LANs)  can  be 
unstable  and  intermittently  unavailable. 

Existing  content  transfer  protocols  are  not  adaptive  to  volatile  network 
connectivity.  If  a  physical  connection  is  lost,  any  information  or  part  of  a  file  already 
retrieved  is  discarded  and  the  same  information  must  be  retransmitted  again  after  the 
reestablishment  of  the  lost  session.  The  intention  of  this  Thesis  is  to  develop  a  protocol  in 
the  application  layer  that  preserves  the  already  transmitted  part  of  the  file,  and  when  the 
session  is  reestablished,  the  information  server  can  continue  sending  the  rest  of  the  file  to 
the  requesting  host.  Further,  if  the  same  content  is  available  from  another  server  through 
a  better  route,  the  new  server  should  be  able  to  continue  to  serve  the  content,  starting 
from  where  the  session  with  the  previous  server  ended. 
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I.  INTRODUCTION 


A.  PROBLEM  STATEMENT 

One  of  the  major  problems  during  the  operation  of  a  wireless  mobile  LAN,  is  the 
reliability  of  the  content  delivery  under  difficult  networking  conditions.  Currently,  an 
error  or  connection  loss  during  a  data  transfer  session  can  only  be  handled  by 
retransmitting  the  data.  However,  in  the  wireless  network  established  to  support  Special 
Forces  teams  in  a  highly  mobile  environment,  the  timely  delivery  of  information  is 
essential  for  the  accomplishment  of  the  mission.  In  this  case,  a  more  rapid  and  dynamic 
data  recovery  must  be  achieved,  so  that  the  interrupted  data  transfer  session  can  be 
continued  from  the  point  it  stopped. 

B.  RESEARCH  QUESTIONS 

Addressing  the  above  problem,  the  current  research  will  address  the  following 
questions: 

•  What  is  an  appropriate  design  for  a  file  transfer  application  so  that  partial 
file  retrieval  can  be  achieved? 

•  What  is  an  example  of  a  high-layer  communication  protocol  that  can  be 
used  in  this  application? 

•  How  can  this  application  design  support  the  use  of  mobile  devices? 

•  How  can  this  communication  model  be  flexible  when  the  availability  of 
the  information  servers  varies? 

C.  SCOPE  AND  METHODOLOGY 

1.  Scope 

The  scope  of  the  thesis  is  to  develop  a  client-server  file  transfer  application 
named  PFTP  (Partial  File  Transfer  Protocol)  to  demonstrate  a  possible  solution  to  the 
problem  of  a  lack  of  persistent  data  sessions  in  wireless  mobile  networks  and  LANs.  For 
this  purpose,  a  prototype  communication  protocol  between  the  client  and  the  server  will 
be  designed  to  achieve  dynamic  partial  file  retrieval  in  the  event  of  connection  loss.  The 
goal  is  to  produce  an  application  user  interface  that  visualizes  the  partial  file  retrieval 
process  in  real  time. 
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2.  Methodology 

This  thesis  research  will  follow  the  methodology  below: 

•  Search  for  partial  file  transfer  capabilities  in  the  existing  file  transfer 
protocols 

•  Specify  the  application’s  requirements  for  both  the  user  interfaces  and  the 
communication  protocol 

•  Design  and  develop  a  file  transfer  application  using  Java  programming. 

•  Test  the  application  in  a  wireless  environment,  against  several  scenarios 
simulating  real  situations  that  can  occur. 

3.  Assumptions  and  Limitations 

a.  Assumptions 

•  Programming  Language.  The  development  of  the  application  will  be  done 
with  Java  Technology  programming.  As  Java  programming  support 
becomes  more  and  more  powerful,  it  contains  the  tools  necessary  to 
support  the  development  of  both  user  interface  and  communication 
protocol  specific  components  for  the  purpose  of  the  thesis  research. 

•  Mobile  Device.  The  mobile  platform  for  the  mobile  client  of  this 
application  is  a  Pocket  PC  technology  device,  which  possesses  a  more  user 
friendly  file  management  system. 

b.  Limitations 

•  Security.  Except  for  the  file  authentication  that  is  achieved  with  the  file 
hash  value  exchange  procedure  during  the  transfer  process,  the  security 
aspect  of  this  protocol  is  not  covered  in  the  manner  in  which  it  can  support 
the  military  use  of  the  application.  A  secure  tunneling  design  would  be 
appropriate  to  encapsulate  each  session  between  the  client  and  server. 

•  File  Database  Management.  The  application  server  has  limited 
functionality  in  the  file  database  management.  The  server  side  creates  a 
local  file  database  that  holds  the  files  that  are  decided  by  the  server 
administrator  to  be  available  for  the  clients  before  it  runs. 

•  Scalability.  Even  though  the  multithreading  approach  is  used  to  design  the 
server  side  of  the  application,  this  thesis  research  does  not  address  the 
capability  to  support  a  large  number  of  users  that  produce  heavy  traffic  on 
a  single  server. 
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D.  ORGANIZATION 

The  covered  material  is  organized  into  the  following  chapters  in  order  to  fulfill 
the  objectives  of  this  thesis.  Chapter  II  will  refer  to  all  the  available  file  transfer  protocols 
and  how  a  built  in  capability  exists  in  some  of  them  for  partial  file  retrieval.  Chapter  III 
will  cover  the  application  design  consisting  of  the  requirements  and  the  UML  diagrams. 
Chapter  IV  will  describe  the  development  process,  referring  to  the  developments  tools 
used,  the  user  interface  functionality  and  how  the  most  important  features  of  the 
application  are  implemented  for  both  the  client  and  server  side.  Chapter  V  will  address 
the  testing  phase  of  the  application  development.  Specific  scenarios  will  test  the  manner 
in  which  applications  respond  to  any  file  transfer  case.  Finally,  Chapter  VI  will  present 
recommendations,  conclusions,  and  further  work  to  be  done  in  the  establishment  of 
persistent  data  sessions  in  file  transfers  within  a  mobile  LAN. 
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II.  BACKGROUND 


This  chapter  refers  to  some  of  the  most  known  file  transfer  protocols  and  how 
some  have  features  that  can  enable  a  form  of  partial  file  recovery.  Also,  it  contains 
information  about  the  mobile  devices’  networking  characteristics,  as  far  as  the  file 
transfer  protocols  they  are  using. 

A.  EXISTING  FILE  TRANSFER  PROTOCOLS 

I.  File  Transfer  Protocol  (FTP) 

FTP  is  the  oldest  of  the  current  file  transfer  protocols,  introduced  for  the  first  time 
in  1971  [1]  .The  last  specification  for  this  protocol  is  described  in  Ref.[2].  FTP  is  a  user- 
level  protocol  for  file  transfer  among  hosts  and  terminal  Interface  Message  Processors 
(IMP)  and  it  uses  the  Data  Transfer  Protocol  (DTP) [3]  to  transfer  the  file  data. 

The  main  goals  of  the  FTP  protocol  are  to: 

•  Use  the  remote  file  storage  between  hosts  conveniently 

•  Promote  the  sharing  of  files 

•  Encourage  its  use  by  computer  programs.  Even  though  ETP  can  be  used 
by  a  PC  user,  it  is  designed  for  use  by  programs 

•  Keep  the  user  safe  from  any  difference  in  file  storage  systems  among  host 
operating  systems 

•  Achieve  reliable  and  efficient  data  transfers 

The  communication  model  of  ETP  is  based  on  the  establishment  of  two 
bidirectional  connections  between  the  client  and  the  server,  the  Control  Connection 
using  port  21  for  the  exchange  of  the  ETP  commands  and  replies  using  Telnet  protocol, 
and  the  Data  Connection  using  port  20  for  the  data  transfers  using  the  TCP  protocol 
(Eigure  1).  The  protocol  interpreter  of  the  client  side  is  that  which  initiates  the  control 
connection  using  the  Telnet  protocol.  After  the  initiation  of  the  control  connection,  the 
user  protocol  interpreter  generates  and  sends  the  ETP  commands  to  the  server  that  uses 
standard  replies  to  respond  through  the  control  connection. 
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Figure  1.  The  use  model  of  the  FTP  protoeol 


FTP  commands  specify  the  parameters  of  the  data  connection  such  as  the  transfer 
mode,  data  port,  file  structure  and  representation  type,  and  what  kind  of  file  operations 
are  requested  such  as  retrieve  ,  store  and  delete.  The  server  then  initiates  the  data 
connection  to  a  data  transfer  port  that  is  specified  by  the  user,  and  sends  the  data  applying 
the  parameters.  The  client  must  listen  to  that  port  that  also  can  be  different  from  the  port 
client  used  to  initiate  the  control  connection.  Except  for  this  client-server  data  transfer, 
FTP  provides  the  capability  so  that  the  user  on  the  client  side  can  tell  the  server  to  send 
the  data  to  another  FTP  server  host  (Figure  2). 


Figure  2.  The  alternative  use  model  of  the  FTP  protocol 
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In  that  case,  control  connections  are  initiated  by  the  client  protocol  interpreter 
with  both  protocol  interpreters  of  the  two  server  hosts  but  the  data  connection  is 
established  between  the  two  servers  for  exchanging  the  file  data.  The  server  that  sends 
the  data  in  both  cases  mentioned  above  is  responsible  for  initiating,  maintaining,  and 
closing  the  data  connection. 

Three  transmission  modes  must  be  supported  by  every  implementation  of  the  FTP 
protocol  for  the  file  data  transfer  to  occur.  They  are  the  stream  mode,  the  block  mode  and 
the  compressed  mode.  In  all  modes,  an  end-of-file  (EOF)  marker,  depending  on  the  file 
structure,  must  explicitly  or  implicitly  indicate  the  end  of  the  data  transfer  or  the  close  of 
the  data  connection  is  identified  as  the  end  of  the  file  indicator. 

In  the  stream  mode,  the  file  data  are  transmitted  as  a  stream  of  bytes  without 
excluding  the  record  structured  files.  In  the  block  mode,  files  are  a  series  of  data  blocks 
that  have  a  tree  byte  header  that  contain  a  one-byte  descriptor  code  and  a  two-byte  count 
field  (Figure  3). 


DesciptorCode 

Count  Field 

8  bits 

16  bits 

\  3k  \ 


Figure  3.  The  data  block  header  in  the  block  transmission  mode  of  FTP 

The  descriptor  code  field  indicates  the  end  of  file  (EOF),  the  end  of  record  (EOR), 
the  restart  marker  or  the  suspected  for  errors  data  marker  with  bit  flags.  The  count  field 
indicates  the  total  length  in  bytes  of  the  data  blocks.  In  compressed  mode,  the 
information  that  must  be  sent  is  the  actual  data  in  a  form  of  byte  string,  the  compressed 
data  that  consist  of  replications  or  filler  and  control  information  [2].  The  n  data  bytes  are 
compressed  to  one  replicated  byte  (Figure  4). 
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Figure  4.  Compression  of  data  bytes  in  the  compressed  mode  of  FTP 


In  general,  FTP  does  not  have  mechanisms  to  detect  if  any  bit  loss  or  the  data 
received  is  scrambled.  This  kind  of  low  level  error  control  is  handled  by  the  underlying 
TCP.  However,  in  the  case  of  a  long  data  transfer,  such  as  in  big  files,  and  in  the  block  or 
compressed  transfer  mode,  a  restart  procedure  exists  that  is  trying  to  protect  the  user 
from  the  failures  of  hosts  or  the  underlying  network  during  the  data  transfer.  The 
procedure  is  based  on  special  market  codes  that  represent  a  data-unit  counter  (bit,  byte  or 
record),  that  the  sender  inserts  in  the  data  stream  at  some  points.  Those  markers,  also 
known  as  checkpoints,  in  the  case  of  a  system  failure,  act  as  milestones  in  the  transfer 
process  and  can  be  used  by  the  user  to  ask  for  data  recovery  by  sending  a  restart 
command,  with  the  marker  code  identified. 

However,  even  though  this  error  recovery  feature  exists.  Ref.  [2]  does  not 
mention  any  implementation  details  and  an  agreement  between  FTP  client/server  vendors 
about  a  common  format  for  the  restart  markers  does  not  exist,  and  therefore,  they  can  be 
used  effectively. 


2.  Trivial  File  Transfer  Protocol  (TFTP) 

TFTP  is  a  very  simple  protocol  that  is  used  to  transfer  files  and  is  described  in  Ref 
[4]  and  revised  by  Ref  [5].  It  is  designed  to  be  on  top  of  the  UDP  protocol  even  though 
other  transport  protocols  are  not  excluded.  To  keep  its  implementation  as  simple  as 
possible,  TFTP  does  not  have  features  that  can  be  found  in  FTP  protocol  such  as 
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directory  listing  and  user  authentication.  Files  can  be  transferred  with  three  modes, 
netascii  (8  bit  ascii  mode)  which  is  a  standard  for  transferring  text  files,  octec  mode 
which  is  for  transferring  binary  files,  and  mail  mode  which  is  for  maiF. 

The  communication  protocol  starts  with  the  TFTP  client  sending  a  read  or  write 
request  on  port  69  of  the  TFTP  server  to  read  or  write  a  file.  If  the  server  accepts  the 
request,  then  a  connection  is  established  and  the  data  are  sent  in  fixed  blocks  of  512 
bytes.  Each  non-terminal  data  packet  must  be  acknowledged  before  the  sender  sends  the 
next  one.  If  a  timeout  period  is  passed  without  acknowledge  reception  for  a  packet,  this 
packet  is  resent.  Packet  reception  with  a  length  less  than  512  bytes  indicates  a  terminal 
file  data  block  and  the  termination  of  a  file  transfer  (Figure  5). 


TFTP 
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Figure  5.  Data  transfer  sequence  in  TFTP 


1  Mail  mode  is  not  implemented  in  commercial  TFTP  applications. 
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In  case  of  a  lost  packet,  the  receiver  sends  its  last  transmitted  packet  to  indicate 
this  loss  and  to  cause  the  senderZ  to  resend  it. 

There  are  four  types  of  messages  that  are  exchanged  between  the  client  and  the 

server: 

•  Read  request  message 

•  Write  request  message 

•  Data  message 

•  Acknowledge  message 

•  Error  message 

All  message  packets  have  a  2  byte  front  opcode  that  identifies  the  format  of  TFTP 
messages  and  then  the  data  depending  on  the  message  type.  Figure  6  shows  the  packet 
structure  of  different  message  packets. 
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File  Name  field,  Transfer  Mode  field:  a  null  ferminafed  variable  length  field 

Figure  6.  Messages  structure  of  TFTP 


2  The  sender  in  TFTP  must  keep  one  previous  sent  data  packet  in  case  of  packet  loss. 
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When  an  error  occurs  (an  error  message  received)  during  the  file  transfer,  the 
designed  reaction  of  the  TFTP  protocol  is  to  terminate  the  connection.  The  error  message 
is  not  acknowledged,  so  when  an  error  message  has  been  lost,  the  receiver  uses  a  timeout 
period  to  detect  this  connection  termination.  In  this  protocol  after  an  abnormal 
termination,  no  procedure  exists  to  retrieve  the  lost  part  of  a  file  after  a  connection  failure 
during  transfer. 

3.  Simple  File  Transfer  Protocol  (SFTP) 

The  simple  file  transfer  protocol  (SFTP)  is  a  protocol  designed  to  be  more  useful 
than  TFTP  but  not  as  powerful  as  FTP  [6] .  SFTP  uses  one  TCP  connection  to  transfer  the 
files  compared  to  one  UDP  connection  of  the  TFTP  protocol  and  the  two  TCP 
connections  of  FTP.  This  characteristic  gives  the  SFTP  the  ability  to  support: 

•  File  transfers 

•  Directory  listing  and  changing 

•  User  access  control 

•  File  deleting  and  renaming 

The  SFTP  communication  protocol  starts  with  the  client  side  connecting  to  the 
server  on  port  115  via  TCP.  Then,  the  client  sends  commands  to  the  server  and  waits  for 
responses.  The  SFTP  commands  and  replies  are  in  the  form  of: 

Commands  :  <4  ASCII  character  command>  [<space>  <arguments>]  <null> 
Replies  :  <I  ASCII  response  character>  [<ASCII  message  string>]  <null>. 

In  Table  1,  all  the  possible  commands  and  replies  are  listed  with  a  short 
description.  Also,  Figure  7  shows  an  example  of  a  command-reply  exchange  that  leads  to 
file  transfer. 
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COMMAND 

DESCRIPTION 

USER 

The  user  ID  on  the  server  system 

ACCT 

The  account  to  use  on  the  server  system. 

PASS 

The  password  on  the  server  system 

TYPE 

The  mapping  of  the  stored  file  to  the  transmission  byte  stream  is 
controlled  by  the  type.  The  default  is  binary  if  the  type  is  not  specified. 

EIST 

Eists  the  directory  contents. 

CDIR 

Changes  the  current  directory  on  the  server  host  to  the  given  one. 

KIEE 

Deletes  the  file  from  the  server  system. 

NAME 

Renames  the  file  on  the  server  system. 

DONE 

Tells  the  server  system  that  the  process  is  finished. 

RETR 

Requests  that  the  server  system  send  a  specified  file. 

STOR 

Tells  the  server  system  to  receive  a  file  and  save  it  under  the  name 
given. 

REPLY 

DESCRIPTION 

+ 

Success. 

- 

An  error  has  occurred 

! 

Eogged In 

<space> 

Number 

Table  1.  Commands  and  replies  of  a  SFTP  communication  protocol 
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Figure  7.  An  example  of  a  file  transfer  connection  in  SFTP 

In  SFTP,  no  way  exists  to  retrieve  the  remaining  part  of  the  file  if  the  traditional 
TCP  connection  fails  during  the  transmission  of  file  bytes. 

4.  Hypertext  Transfer  Protocol  (HTTP) 

The  Hypertext  Transfer  Protocol  (HTTP)  as  described  in  Ref.  [7]  is  an 
application-level  protocol  that  is  used  for  the  transfer  of  hypermedia  information  on  the 
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Internet.  HTTP  is  a  request  /response  type  of  transfer  protocol.  The  client  opens  a 
connection  with  the  server  and  sends  a  request.  The  server  responds  to  this  request  and 
closes  the  connection.  These  connections  can  be  persistent  by  choosing  TCP  as  the 
underlying  protocol. 

The  client  side  user  initiates  the  communication  protocol  connecting  to  port  80  of 
the  HTTP  server  host  and  sends  a  request.  The  client  request  can  be  fulfilled  by  three 
general  cases.  In  the  first  case,  the  client  request  reaches  the  origin  server  through  a 
single  connection  and  the  response  comes  from  the  same  connection  and  server  (Figure 
8(a)).  In  the  second  case,  there  are  some  intermediaries,  such  as  gateways  and  proxies, 
between  the  client  and  the  origin  server  that  maybe  do  not  understand  the  message  but  act 
as  a  relay  point  (Figure  8(b)). 

The  third  is  the  case  when  the  HTTP  request  and  responses  between  the  client 
user  and  origin  server  can  be  cached  and  reused  to  lower  the  traffic  to  the  origin  server 
(Figure  8(c)). 
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Figure  8.  The  types  of  request  fulfillment  in  HTTP  protocol 
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HTTP  protocol  is  designed  so  that  it  is  possible  to  request  one  or  more  parts  (or 
ranges)  of  a  hypermedia  information  file,  instead  of  the  entire  file.  For  that  purpose, 
special  range  request  headers  can  be  used  and  the  HTTP  servers,  as  is  proposed  by 
Ref. [5],  ought  to  support  range  request  headers  when  possible,  because  it  is  an  efficient 
way  to  recover  from  the  partially  failed  transfer  of  large  files. 

B.  FILE  TRANSFER  IN  MOBILE/  HANDHELD  DEVICES 

By  the  time  people  become  accustomed  to  having  a  mobile  or  a  handheld  device 
which  helps  them  stay  connected  with  other  people  or  organize  their  business  or  family 
life,  new  capabilities  have  been  examined  to  bring  those  devices  to  the  Internet  and  inter¬ 
networking  community.  Newer  enhancements  in  mobile  phones  bring  the  Internet-ready 
cellular  phones  or  Web  phones  in  use,  making  them  able  to  access  the  Web,  running 
micro-browsers.  Wireless  enabled  handheld  devices,  such  as  Palm  or  Pocket  PCs,  having 
more  computational  power  and  memory,  can  also  store  data  locally  in  the  form  of  records 
or  regular  files  respectively.  Due  to  the  need  for  Internet  access,  the  most  popular  file 
transfer  protocols  among  these  devices  is  HTTP,  but  software  vendors  have  not  enabled 
any  partial  recovery  capabilities,  where  they  are  available  and  the  only  way  to  handle  a 
failed  file  transfer  connection  is  to  resend  the  file. 
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III.  APPLICATION  DESIGN 


This  chapter  presents  the  initial  requirements  that  the  application  addresses.  In 
Section  B,  the  UML  diagrams  show  how  the  application  is  designed  in  greater  detail. 


A.  REQUIREMENTS 

1 .  F unctional  Requirements 

a.  User  Interface 

The  PFTP  application  will  provide  a  user  interface  for  both  the  client-side 
and  server-side  modules.  In  this  initial  version,  and  for  the  purpose  of  the  thesis  research, 
the  user  interface  must  provide  four  main  services  to  the  client-side  user.  They  are: 

•  Control  of  the  file  transfer  communication.  The  user  must  be  able  to 
control  different  options  of  the  file  transfer,  such  as  the  file  name,  server 
selection/configuration  mode,  and  the  packet  size.  Also,  there  must  be  an 
option  for  the  user  to  stop  or  cancel  the  file  transfer  at  any  time. 

•  View  of  the  file  transfer  progress.  A  file  transfer  progress  bar  with  the 
percentage  of  the  transfer  finished  will  be  sufficient. 

•  View  of  the  file  transfer  status.  Useful  information  must  be  accessible  by 
the  user  during  the  file  transfer. 

•  Visual  preview  of  the  file  during  transfer  in  the  case  of  an  image  file. 

These  services  can  be  represented  as  separate  panels  on  the  main  user 

interface  frame.  Figure  9  shows  a  primitive  preview  of  an  example  of  a  PFTP  client  side 
user  interface. 
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PFTP  Client 


Ccntrol  Panel 


Image  Progress  Panel 


T ransfer  Status  Panel 


T ransfer  Progress  Panel 


Figure  9.  Preview  of  the  client’s  user  interface  in  PFTP  application 

In  the  Pocket  PC  version  of  the  PFTP  client,  it  is  not  possible  to  show  all 
the  above-mentioned  panels  concurrently,  due  to  the  screen  size  of  this  device.  In  that 
case,  the  control  panel  will  be  the  main  panel  and  the  image  progress  panel  will  appear 
when  the  file  is  downloading. 


PFTP  Pocket  PC  Client 


Control  Panel 


PFTP  Pocket  PC  Client 


Image  Progress  Panel 


Figure  10.  Preview  of  the  Pocket  PC  version  client’s  user  interface 

The  PFTP  server-side  user  interface  must  support  limited  control  and 

administration  functionality  for  the  server  application.  These  functions  will  be: 
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•  Limited  server  application  control.  A  simple  starting  and  stopping 
functionality  will  be  available. 

•  File  database  management.  The  server  has  a  local  file  database  that  keeps 
the  files  available  to  clients  for  transfer.  The  server  application  user  can 
add  or  remove  files  from  the  database. 

•  Monitoring  the  server’s  operation.  When  the  server  starts,  a  panel  must  be 
present  to  show  the  operation  status  and  some  connection  failure  statistics. 

The  first  two  of  the  above  functionalities  can  be  available  as  a  menu  item 

in  a  menu  bar  at  the  top  of  the  user  interface.  Under  this  a  panel  can  be  placed  displaying 

a  logo  before  the  server  application  starts  or  the  server-monitoring  panel  after  server 

initialization.  Figure  11  shows  the  intentional  user  interface  preview. 


Figure  11.  Preview  of  the  server’s  user  interface  in  PFTP  application 
b.  File  Transfer 

The  file  transfer  from  the  PFTP  Server  to  the  PFTP  Client  results  from  a 
client-side  user  request.  The  user  selects  the  preferred  features  of  the  file  transfer  (file 
name,  PFTP  server,  packet  size),  and  asks  to  download  it.  The  server  sends  the  file  as 
packets  (arrays  of  bytes)  that  the  client  collects  until  it  receives  all  of  them.  The  client 
application  keeps  track  of  the  number  of  packets  received,  and  in  case  of  a  failure  in  the 
connection,  keeps  attempting  to  reconnect  with  the  server  and  send  a  request  to  retrieve 
the  rest  of  the  file  packets. 


19 


c. 


File  Database 


The  server  of  this  application  must  keep  a  file  database  to  store  the  files 
available  to  the  clients  for  transfer.  The  server  cannot  start  unless  the  user  first  adds  files 
to  the  database.  Any  file  can  be  removed  at  any  time  from  the  database  but  the 
application  stops  running  when  the  database  becomes  empty.  Client-side  user  is  advised 
when  the  server  file  database  is  empty. 

d.  File  Authentication 

After  a  connection  failure  and  during  the  reconnection  period,  the  client 
will  request  the  same  file  either  from  the  same  or  another  PFTP  server.  In  order  for  the 
server  to  know  if  it  has  the  right  file  (same  name,  modification,  or  content)  with  this 
name,  it  must  use  a  value  that  uniquely  identifies  it.  A  hashing  algorithm  such  as  MD5 
can  produce  a  hash  value  for  the  file  that  is  sufficient  for  this  authentication  check.  That 
value  will  be  sent  by  the  server  to  the  client  after  the  initial  file  request,  so  that  it  can  be 
available  later,  to  be  included  in  the  partial  file  recovery  request  to  another  PFTP  server, 
in  the  event  of  a  connection  loss. 

e.  PFTP  Server  Availability 

PFTP  client-side  keep  a  list  of  the  PFTP  server  IP  addresses  to  try  during 
the  reconnection.  For  better  performance  a  getServer()  function  should  be  called  that  can 
search  for  a  valid  server  to  connect  to,  which  is  beyond  the  scope  of  the  thesis  research 
Also,  the  client-side  user  can  add  any  additional  PFTP  server  available  at  a  later  time. 

/.  Client-Server  Communication  Protocol  and  User  Interaction 

PFTP  is  an  application  layer  protocol  and  it  is  based  on  a  client-server 
communication  scheme.  For  the  file  transfer  process,  an  application  layer  communication 
protocol  must  be  established.  The  TCP  protocol  is  the  underling  protocol  for  every 
connection  and  data  transfer  between  the  client  and  server  (Figure  12). 
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Figure  12.  The  communication  scheme  of  PFTP  application 
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This  communication  protocol  is  shown  in  Figure  13  and  starts  with  the 
PFTP  server  running  and  waiting  for  clients  at  port  6789.  When  the  user  opens  the  PFTP 
client  application,  it  must  choose  a  PFTP  server  manually  or  from  a  list  of  already 
existing  servers  in  order  to  retrieve  the  list  of  files  available  for  transfer.  In  the  predefined 
server  case,  an  Auto  server  mode  option  exists  which  can  be  selected  when  the  user  wants 
the  application  to  choose  a  predefined  PFTP  server  randomly  during  either  the  initial 
available  file  retrieval  or  the  partial  file  retrieval  process  after  a  connection  loss.  When 
the  file  list  is  retrieved,  a  user  selects  a  file  name  and  the  packet  size  and  forms  a  file 
request  packet  that  is  sent  to  the  server.  The  request  packet  fields  are  shown  in  Figure  14. 


File  Request  Message: 


Request 

Type 


File 

Name 

s. 

File  Name 
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Offset 

Packet  Size 

Figure  13.  The  communication  scheme  of  PFTP  application 


The  server  checks  if  it  has  the  file  and,  if  it  does,  sends  the  file  size  and  the 
hash  value  of  the  file  back  to  client.  Then  the  server  starts  reading  the  file  data  and  sends 
it  in  packets  to  the  client.  If,  during  the  packet  transmission,  a  connection  failure  occurs, 
the  client  side  generates  partial-file-request  packet,  setting  the  offset  field  value  with  the 
next  expected  packet  counter  and  the  hash  field  value  with  the  file  hash  received  at  the 
start  of  the  file  transfer.  Then,  the  client  attempts  to  reconnect  with  the  same  server  or,  if 
the  Auto  server  mode  selected,  with  the  next  available  PFTP  server,  and  when  it  is 
connected,  sends  the  prepared  partial-file-request  packet. 
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Figure  14.  The  communication  protocol  of  PFTP  application 


The  server  that  receives  the  packet,  if  the  offset  value  is  greater  that  zero, 
checks  if  it  has  the  same  file  with  the  same  hash  value  and  continues  sending  the 
remaining  data  in  packets  to  the  client.  Each  file  connection  loss  causes  the  same  partial- 
transfer  retrieval  scheme  until  the  client  receives  all  the  file  packets  and  both  the  client- 
and  server-sides  close  the  connection. 
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2.  Non  Functional  Requirements 

a.  User  Requirements 

The  user  of  the  client-side  application  must  have  some  experience  using 
the  graphical  user  interface  window  on  a  desktop,  a  laptop  and  Pocket  PC  devices;  using 
a  mouse  or  stylus  to  select  items  from  a  drop  down  list;  pressing  the  buttons;  and  exiting 
an  application  by  closing  its  window.  Also,  the  user  must  possess  at  least  minimal 
network  technology  knowledge  to  understand  how  the  client-server  concept  works.  This 
includes  information  such  as  that  the  server  program  must  be  running  first  so  a  client  can 
connect  to  it.  The  system  will  then  help  the  user  by  providing  sufficient  information  in 
the  Transfer  Status  Panel  and  by  using  message  windows.  The  knowledge  as  to  how  a 
network  connected  device  can  be  set  up  must  be  available. 

b.  Hardware 

The  PFTP  application  does  not  require  any  exceptional  computational 
power  in  both  the  desktop/laptop  and  the  Pocket  PC  version.  Some  minimal  system 
requirements  are: 

•  PFTP  Server:  Pentium  III  500  MHz  processor,  128  MB  RAM,  Network 
Interface  Card,  a  static  IP  address  (no  DHCP). 

•  PFTP  Client  (desktop/laptop):  Pentium  III  500  MHz  processor,  1 28MB 
RAM,  Wireless  Network  Interface  Card 

•  PFTP  Client  (Pocket  PC):  Pocket  PC  ARM  compatible  handheld,  16MB 
of  RAM,  802. 1  lb  wireless  adapter 

c.  Software 

The  following  software  must  be  present  so  the  PFTP  application  can  run 

properly: 

•  PFTP  Server:  Windows  98,  NT,  2000  or  XP  operating  system  and  a  Java 
Virtual  Machine. 

•  PFTP  Client  (desktop/laptop):  Windows  98,  NT,  2000  or  XP  operating 
system,  Java  Virtual  Machine  and  the  Java  2  SDK1.4  installed. 

•  PFTP  Client  (Pocket  PC):  Pocket  PC  2002  or  greater  and  a  Java  Virtual 
Machine,  such  as  Jeode  JVM,  installed. 
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B.  UML  DIAGRAMS 


1.  Use  Case  Diagrams 

The  basic  actors  of  the  PFTP  application  are  the  users  of  the  client-side 
and  the  server-side  user  interface,  as  well  as  the  client  and  server  systems.  Figure  15 
demonstrates  the  possible  use  cases  that  the  user  interface  allows: 

•  The  server  user  adds  a  file  to  the  server’s  file  database 

•  The  server  user  removes  a  file  from  the  server’s  file  database 

•  The  client  user  asks  for  a  file  from  the  server  for  the  first  time 

•  The  client  user  decides  to  cancel  the  file  transfer  without  saving  any  data 

already  transferred 

•  The  user  decides  to  retrieve  a  partial  transferred  file  at  a  later  time 


Figure  15.  The  use  case  diagram  of  the  PFTP  application 
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2. 


Class  Diagrams 
a.  User  Interface  Classes 

Figures  16,  17  and  18  show  the  class  diagram  of  the  PFTP  client  for  the 
desktop/laptop,  the  Pocket  PC  and  server  versions.  The  user  interface  for  this  client-side 
version  is  a  main  frame  that  contains  four  panels  to  control  the  client  and  monitor  the 
progress  of  the  file  transfer.  All  the  panels  except  the  control  panel  start  by  the  initiation 
of  a  file  transfer.  After  the  file  is  transferred,  all  panels  reset  for  the  next  file  transfer 
request. 
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-container :  Containa 

-layout :  GrdBagLayout 

-constraiits  :  GridBagConstraints 

-transferProgressPanel :  TransferProgressPanel 

-transferStatusPanel :  TransferStatusRanel 

-imageProgressPanel :  ImageProgressPanel 

-fitelsTransfering :  Boolean 

-askTheFile  :  Boolean 

-dientSocket  :  Socket 

-outObjectToSaver :  ObjectQjtputStream 

-inObjectFromServer :  ObjectOutputStream 

-fiteRequest :  PFTPFileRequest 

-ddPartialTranfa Request:  FlashMap 

-ddPartialTransfersBytes  :HashMap 

-ddPartialTransfersFiles  :ArrayUst 

-server AvailableFies  :  ArrayList 

-fiteNameToAsk :  String 

-serverMode  :Strng 

-fiteHash  :  String 

-fiteSize  :  int 

-offset :  ht 

-packetSize  :int 

-fiteInBytes  :byteO 

-packetCounter :  ht 

-numberOfPackets  :  int 

-startTime :  long 

-stopTime :  long 

-totalFileT ransferTime ;  bng 

-connectionStatus  : String 

-connectionLossTimes  :  int 

-wantFie  :  Boolean 

-fiteTransfered  :  Boolean 

-cancelFileTransfer :  Bodean 

-retrieveFaiedTransfers :  Boolean 

-partialRetr'evedFileName :  Boolean 


-roper  atonif) 

-raddPanelO 
-rselectServerO  :  String 
-rgetSaverAvaihbleFiesO  :  ArrayList 
-raskForFileO 
-rcancelFileT  ransfer( ) 

-rsetF  PeNameToAskO 
-rsetAskTheFieO 
-rsetServerModeO 
-rsetPacketSze  ( ) 

-rsetOffsetO 

-rgetFleNameToAskO  :  Strhg 
-rgetSaverModeO  :  String 
-rgetPacketSze( )  tint 
-rgetOffset( ) :  int 
-rgetFPeSzeO  :int 
-rgetNumOfPacketsO  tint 
-rgetReceivedPacketsO  tint 
-rgetFPeInBytesO  :byte[] 

-rgetConnectionStatusO  :  String 
-rgetConnectionLossTimesO  :  int 
-rgetTotalFieTransfaTime^)  tint 
-rgetFieTransferedO  :  Boolean 
-rgetContrdPanelO  tControlPanel 
-rgetTlledPanel() :  JTextPane 
-rsavePartialFileRequestO 
-rdeletePartialFPeRequestO 
-rresetApplicalionO 
-rstartCheckToAskO 

-rdelayO _ 


PFTPCIientttControlPanel 


-controlPanelClient  :  PFTPCIient 
-progressPanel :  TransferProgressPanel 
-statusPanel  :  TransferStatusPanel 
-imagePanel  :  ImageProgressPanel 
-controlPanelTitle  :  JPanel 
-fiteCtxriceDialog  :  RIeSelectionDialog 
-fiteCtxjiceField  :  JTextFieb 
-serverModeChdceBox  tJComboBox 
-packetSzeChoceBox  tJComboBox 
-fiteButtonGroup :  ButtonGroup 
-serverButtonGroup :  ButtonGroup 
-previousFailedFies  :  JRadioButton 
-fitesFromServer :  JRadioButton 
-manualServerSelection :  JRadioButton 
-predfinedServerSdection :  JRadbButton 
-setectServer :  JButton 
-retrieveAvailabbFiles  :  JButton 
-askTheFile :  JButton 
-cancelTransfer :  JButton 
-manualSelectServer :  JTextFieb 
-serverlPs :  String[] 

-packetSzes  tStrhgfl 
-fibSebction  :  Strhg 
-serverSelection  :  String 
-packetSzeSeledbn  :  String 
-fibSebcted  :  Boolean 
-serverSelected :  Boolean 
-packetSzeSeleded  :  Bodean 


-rsetFibSdectedO 
■r-reset( ) 


PFTPCIient:  :T  ransferStatusPanel 


-transferStatusPaneCient :  PFTPCIient 
-transferStatusPanefTitle:  JTextPane 
-fieAskedInfo  :  JTextPane 
-fieSzeInfo  :  JTextPane 
-packetSizeUsedInfo :  JTextPane 
-connedbnStatusInfo :  JTextPane 
-connedbnLossTimesInfo  :  JTextPane 
-tdafTransferTimelnfo:  JTextPane 


-rupdateFileTr  ansf  er  Status() 
+reset() 


PFTPCIient  ::T  ransferProgressPanel 


-transferProgressPanelClient :  PFTPCient 
-downloadMessagePand :  JPanel 
-downloadMessage  :  JLabel 
-progressBarPanel  tJPand 
-progressBar :  JProgressBar 
-downloadPercentagePanel :  JPanel 
-downloadPercentage :  JLabel 
-f  ieT  oTransfer :  Str  ing 


+setProcr  essBarMaxO 
+updateProgressBat( ) 
-r-resetO 


PFTPCItentttImageProgressPanel 


-imageProgressPaneCient :  PFTPCIient 
-imageProgressLabel:  JLabel 
--updatedTimes:  int 

-fieNameToPreview :  String _ 

-rupdatelmageProgressO 

-rresetO 


Figure  16.  The  class  diagram  of  the  PFTP  Desktop/Laptop  Client  user  interface 
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PFTPCIlentPPC 


•clientSocket  :  Socket 

•inObjectFromServer :  ObjectlnputStream 

•outdbjectToServer :  ObjectOutputStream 

•fileRequest :  PFTPFileRequest 

•ddPartialTransfersRequests :  Vecta 

•ddPartialTransfersBytes  :  Vector 

•ddPartialTransfersFiles :  Vector 

•server AvailableFles  :  Vector 

•fileNameToAsk ;  String 

•serverMode  :Strhg 

•fileHash  :  String 

•fileSize  :  int 

•offset  ;  int 

•packelSize  :  int 

•fileInBytes  :  byteD 

•packetCounter :  int 

•numOfPackds :  int 

•startTime ;  bng 

•stopTime :  long 

•totalfileTransferTime ;  long 

•connectionStatus  : String 

•connectionLossTimes  :  int 

•messageOptbn  :  String 

•wantFile :  Boolean 

•fileTransferred:  Boolean 

•cancelFibTransfer :  Bodean 

•retreivefelecffransfers  :  Boolean 

•PartialRetreivedFibName  :  String 

•container :  Container 

•controlPanel :  ControlPanel 

•imageProgressPanel :  ImageProgressPanel 

•filelsTransferring :  Boolean 

•askTheFile  :  Bodean 


-openStreamsO 
-selectServer()  :String 
-getServerAvailadeFiles  ()  :  Vector 
+askForFite() 
+cancelFileTransfer() 

+set  F  ile  N  am  eT  oAsk( ) 
+setaskTheFie() 
+setServerMode() 
+setPacketSze() 

+setOffset( ) 

+getServerl\/lode()  :String 
+getFieNameToAsk()  :  String 
+getPacketS2e()  :int 
+getFieSize()  :int 
+getNumOfPackets()  :int 
+getReceivedPackets()  :int 
+getFielnBytes()  :byle[] 
+getConnectionStatus()  :  String 
+getConnectionLossTimes()  :  int 
+getTdalFileTransferTime()  :long 
+getFleTransferred() : Boolean 
+getConlrdPanel()  :CortrolPanel 
+savePartialFileRequest() 
+deletePartialFleRequest() 
+resetApplicalbn() 
+startCheckToAsk() 

+delay() 

+operatbn2() 


PFTPCIlentPPC::  Cont  rol  Panel 


-controlPanelClient :  PFTPCIlentPPC 
-imagePanel :  ImageProgressPanel 
-controlPanelTitle :  Panel 
-fibChoiceDialog  :  FibSebctionDialog 
-fibChoiceLabel  :  Label 
-serverModeChdceList :  List 
-packet  SzeChoiceUst  :  List 
-FileButtonGroup  :CheckboxGroup 
-serverButtonGroup :  CheckboxGroup 
-previousFailedFiles  :  CheckBox 
-fibsFromServer :  CheckBc»( 
-manualServerSelection :  CheckBcK 
l-predefhedServerSetection :  CheckBox 
-selectServer :  Button 
-retreiveAvailabbFiles  :  Button 
-askTheFile :  Button 
-cancelTransfa  :  Button 
-manualSelectServer :  TextFieb 
-emptyFleUst  :StrrgO 
-serverlPs :  String[] 

-packetSzes  :  StringD 
-fibSebction  :  String 
-serverSelection  :  String 
-packetSzeSelection  :  String 
-fibSelected  :  Booleai 
-serverSelected :  Boolean 
-packetSzeSelected  :  Bodean 


-i-setFi  ©Selected  0 
-i-reset() 


PFTPCIienlPPC::lmageProgressPanel 


■imageProgressPanelClent :  PFTPCIlentPPC 
■imageCanvas :  PFTPCanvas 
■imageCanvasDimension :  Dimensbn 
■updatedTimes :  int 
■fileNameToPreview :  String 


-Hupdale  lmageProgress() 


PFTPCanvas 


-canvasimage  :  Image 


-i-setlmage{) 
-i-getlmage{) :  Image 
-i-update{) 

-Hpaintp _ 


F^TPCIientPPC::FlleSelectlonDlalog 


■dalogClient :  PFTPCIlentPPC 
■dalogContrdPanel :  ControlPanel 
■dalogTextield  :  Label 
■item  List  :StringD 
■dalogComboBox  :List 
■dalogButton  :  Button 
■dalogSelection  :  String 


PFTPCIientPPC  ::FrontDlalog 


•diabgClient :  PFTPCIientPPC 
•diabgcontrolPanel :  ControlPanel 
•diabgTextField :  Label 
•imageCanvas :  PFTPCanvas 
•imageCanvasDimension  :  Dimension 
•useltButton:  Button 


PFTPCIientPPC::  MessageDialog 


-dalogClient :  PFTPCIientPPC 
-dialogTitle  : String 
-dialogTextField  :  Label 
-dialogButton  :  Button 
-messageType :  int 
-dialogMessage  :  String _ 


Figure  17.  The  class  diagram  of  the  PFTP  Pocket  PC  Client  user  interface 
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PFTPServer 


serverSocket :  ServerSocket 
marSocket  :  Socket 
fis  :  FilelnputStream 
fileMap  :  AvailableFileMap 
fileNamesI  nMap  :  ArrayList 
startListening  :  Boolean 
exitApplication  :  Boolean 
numberOfCurrentClients :  iit 
numberOfTotafTranfers:  int 
numberOfTransferFailures:  iit 
percentageOFtransferFaiures :  double 
numberOfLocdFies  :  Int 
statusPanel  :  PFTPServerStatusRanel 
startServerltem :  JMenultem 
flleMenu  :  JMenu 
startServerltem :  JMenultem 
stopServerltem  :  JMenultem 
addFlleltem  :  JMenultem 
removeFlleltem  :  JMenultem 
deleteFlleFrame  :JFrame 


+startLlstenlng() 

+delay() 

+selectFlle()  :  File 
removeFr  omDatabaseO 
+setN  Lm  berOfCur  rentCltents() 

+setN  Lm  berOfT  otaFT  ransfers() 

+setN  LmberOfTransferFailures() 
setPercentageOITransferFallureE( ) 
l+setN  Lm  berOfLocalF  lles() 
getNumberOfCurrentClents()  :lnt 
getNumberOfTotarPransfer^)  :lnt 
getNumberOfTransferFalluresO  :lnt 
getPercentageOfTransferFallure£()  :lnt 
getNumberOfLocalFllesO  :lnt 


PFT  PServer  PFTPServerSt  at  usPanel 

-serverStatusPanelServer  :  FFTPServer 
-serverStatusPanelTitle  :JTextPane 
-numberOfcurrentclientsInfo  :  JTextPane 
-numberOfT otalT ransferslnfo :  JTextPane 
-percentageOfTransferFailuresInfo:  JTextPane 
-numberOfLocalFilesInfo :  JTextPane 

1  t 

1 

+getTltledPaneO  :  JTextPane 
+updateServeraatus() 

+reset() 

PFT  PServer:  :Del  et  eF  ileFrame 

-fllesToDelete  :JComboBox 
-flleNames  rStrlngQ 
-deleteButton  :  JButton 
-flleSelected  :  Srlng 

♦1  1 

1 

Figure  18.  The  class  diagram  of  the  PFTP  Server  user  interface 
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b.  Desktop/Laptop  PFTP  Application  Version 


PFTP  Client  GUI 


PFTPCIlent 


-container :  Container 

-layout :  OidBagLayout 

-constraints :  GrdBagConstraints 

-transferProgressPanel:  TransferProgressPanel 

-tr  ansfer StatusPanel :  T ransferStatusPanel 

-imageProgressPanel :  ImageProgressPanel 

-filelsTransferrg :  Boolean 

-askTheFie :  Boolean 

-clientSocket  :  Socket 

-outObjectT  oServer :  ObjectOutputStream 

-InObjectFromServer :  ObjectOutputStream 

-fileRequest :  PFTPFieRequest 

-oldPartiafTranferRequest:  HashMap 

-oldPartiaTransfersBytes :  HashMap 

-oldPartiafTransfersFies :  ArrayUst 

-serverAvailableFiles  :  ArrayList 

-fileNameToAsk :  String 

-serverMode:  String 

-fileHash  :  String 

-fileSize  :int 

-offset :  int 

-packetSze  :  int 

-fileInBytes  :byte(] 

-packetCounter :  int 
-number  OPackets :  int 
-startTime :  long 
-stopTime  :  long 
-totalFileTransferTime:  long 
-connectionStatus  :  String 
-connectionLossTimes  :  int 
-wantFile:  Boolean 
-fileTransfered:  Boolean 
-cancelFieTransfer :  Boolean 
-retrieveFailedTransfers:  Boolean 
-partialRetrievedFileName:  Boolean _ 


-i-operation1() 

-i-addPanel() 

-i-selectServer() : String 
•getServerAvailableFilesO  : ArrayUst 
-i-askForFileO 
-i-cancelFileT  ransfer() 
-i-setFileNameToAsk( ) 
-i-setAskTheFile() 

-i-setSetverMod^) 

-i-setPacketSize() 

-i-setOffset() 

•getFileNameToAsl<) : String 
getServerModd)  :  Qring 
getPacketSizeO  :int 
getOffsetO  :  rt 
getFileSizeO  :  int 
getNumOfPacketsO  :irt 
getReceivedPacketsO  :int 
getFileInBytesO  :  byteQ 
getConnectionStatusO : String 
getConnectionLossTimesO  :int 
getTotalFileTransferTimes()  :int 
getFileTransferec()  :  Boolean 
getControlPandO  :ControlPanel 
•getTitledPanelO  :  JTextPane 
-i-resetApplioation() 

-i-startCheckToAsk() 

-i-del^O _ 


PFTPServer 


-serverSocket  :  ServerSocket 
-mainSocket :  Socket 
-fis :  FieInputStream 
-fieMap  :  AvaiableFieMap 
-fieNamesInMap :  ArrayList 
-startListening  :  Boolean 
-exitApplication  :  Boolean 
-numberOfCurrentClerts:  int 
-numberOfTotalTranfers:  int 
-numberOfTransferFailures:  int 
-percentageOFtransferFailires :  double 
-numberOfLocalFiles  :  int 
-StatusPanel :  PFTPServerStatusPanel 
-startServerltem :  JMenultem 
-fieMenu  :  JMenu 
-startServerltem :  JMenultem 
-stopServerltem  :  JMenultem 
-addFileltem  :  JMenultem 
-removeFHeltem  :  JMenultem 
-deleteFileFrame :  JFrame 


|-i-startListening() 

•ctelayO 

|-i-selectFie()  :File 
removeFromDatabas^) 
-i-setNumberOfCurrentCients() 
-i-setNumberOfT  otalT  ransfers() 
-i-setNumberOfTr ansfer  Failure^ ) 

-i-set  PercentageOfTransferFaiures() 
-i-setNumberOfLocalFilesO 
•getNumberOfCurrentClents()  :int 
getNumberOfTotalTransferg;)  :rt 
getNumberOfTransferFailure^)  :int 
getPercentageOfTransferFailures()  :int 
getNumberOfLocalFilesQ  :int _ 


\-0  PFTP  Saver  GUI 
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l-capacity  :  int 


Aval  lab  leFileMap 


getCapacityO  :int 
setCapacityO 
hasFileO  :  Boolean 
getFileBytesO  :byteD 
aJdFleO 
removeFile() 


I 

1 

P  FTPServer::C  li  en  t  Han  d  ler 

-clientSocket  :  Socket 
-inObjectFromClient :  ObjectInputStream 
-outObjectT oClient :  ObjectOutputStream 
-request :  PFTPFileRequest 
diles Available  :  Vector 
-requestType :  int 
dileName :  String 
dileHash  :  ^ring 

1 

-packetSize  int 
-offset :  int 
-numOfBytes  :  int 

-i-run() 

-i-openStreams() 

-i-handleFileRequestO 

-i-cbseConneabn() 

-i-getHashValue()  :  String 
-i-checkHash{) :  Boolean 
-i-sendFile{) 

Figure  19.  The  class  diagram  of  the  PFTP  application 
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c.  Pocket  PC  PFTP  Application  Version 

The  main  difference  with  desktop/laptop  version  is  that  in  Pocket  PC  the 
classes  that  were  used  are  less  in  number  because  lower  version  of  JDK  (1.1.8)  is 
appropriate  to  use  for  these  devices. 


PFTPCIientPPC  GUI 


PFTPCIientPPC 

o- 

■cllentSocket  :  Socket 

- inObjectFromServer :  ObjectInputStream 

-outObjectToServer :  ObjectCXJtputSream 

-flleRequest :  PFTPFIIeRequest 

-ddPartlalTransfersRequests:  Vector 

-oldPartlalTransfersBytes :  Vector 

-oldPartlalTransfersFiles  :  Vector 

•server AvallableFlles  :  Vector 

•flleNameToAsk  :String 

•server Mode :  String 

•flleHash :  String 

•flleSize  :  int 

•offset :  ht 

•packetSize  :int 

•fileInBytes  :  byteD 

•packetCounter :  int 

•numOfPack^s  :  int 

•startTime:  long 

•stopTime :  long 

•totalfileTransferTime :  long 

•connectionStatus  :String 

•connectionLossTimes  :  int 

•messageOption :  String 

•wantFie:  Boolean 

•fileT  ransferred :  Boolean 

•cancelFileTransfer :  Boolean 

•retreivefeiledTransfers :  Boolean 

•PartialRetreivecFileName :  Srhg 

•container :  Containa- 

•controlPanel :  ControlPanel 

•imageProgressPanel :  ImageProgressPanel 

•filelsTransferring:  Boolean 

•askTheFile  : Boolean 

•openStreams() 

•  selectServerO  :Strhg 
•getServerAvaiabeFilesO  :  Vector 
faskForFileO 
■hcancelFieTranstaO 
■hsetFileNameToAskO 
■hsetaskTheFileO 
■hsetServerModeO 
■hsetPacketSize  () 

■hsetOffset  0 

■hgetServerModeO  : String 
■HgetFlleNameToAskO  :  String 
■hgetPacketSzeO  :int 
■hgetFileSzeO  :int 
■hgetNumOfPacketsO  :  int 
■hgetReceivedPackets  0  :int 
■hgetFilelnBytesQ  :byt^l 
■hgetConnectionStatus()  :  String 
■hgetConnectionLossTimesO  :int 
■hgetTotalFileTransferTimeO  :long 
■hgetFlleTransfaredO  :  Boolean 
■hgetControlPanelO  :  ControlPanel 
■hresetApplication  () 

■hStartCheckToAskO 

■hdelayO 

PFTPServer 

-serverSocket :  ServerSocket 
-mainSocket :  Socket 
-fis :  FileInputStream 
-fileMap  :  AvaiableFieMap 
-fileNamesInMap :  ArrayUst 
-startListening  :  Boolean 
-exItAppllcation  :  Boolean 
-numberOfCurrentCllents:  int 
-numberOfTotalTranfers:  int 
-numberOfTransferFaiures:  Int 
-percentageOFtransferFailures :  double 
-numberOfLocalFlles :  int 
-statusPanel :  PFTPServerStatusPanel 
-startServerltem:  JMenultem 
-fileMenu  :  JMenu 
-startServerltem:  JMenultem 
-stopServerltem :  JMenultem 
-addFileltem :  JMenultem 
-removeFileltem :  JMenultem 
-deleteFlleFrame :  JFrame 
-i-startListenrg  () 

-i-delayO 

-i-selectFIleO  :Flle 
-i-removeFromDatabas^) 
-i-setNumberOfCurrentCients() 
-i-setNumberOfTotalT  ransfers() 
-i-setNumberOfTr  ansf  er  Failures! ) 

-i-set  PercentageOf  T  ransferFallures(} 
-i-setNumberOf  LocalFiles  () 
-i-getNumberOfCurrentClient^)  :lnt 
-i-getNumberOfTotalTransfer^}  :int 
-i-getNumberOfTransferFaiure^)  :int 
-i-getPercentageOfTransferFaiures()  :  Int 
-)-getNumberOfLocalFlles()  :  Int 


PFTPServer  GUI 


1 


1 


Aval  lab  leFileMap 

-capacity  :  int 
-hgetCapadtyO  :int 
-HsetCapacityO 
-i-hasFieO  :  Boolean 
-hget  FileBytesO  :  byte  D 
-i-addFile(} 

0,.’  -hremoveFileO 


PFTPSen/er:ClientHandler 

-cllentSocket  :  Socket 

-InObjectFromCllent :  ObjectInputStream 

-outObjectToCient :  ObjectOutputStream 

-request :  PFTPFIIeRequest 

^lle^vailable  :  Vecta 

-requestType:lnt 

-flleName :  String 

-flleHash  :  String 

-packetSze  :  ht 

-offset :  Int 

-numOfBytes  :  Int _ 

-rfunO 

-topenSlream^) 

-diandleFieRequestO 

-fcloseConnectlonO 

4getHashValue{)  :  String 

-fcheckHash  {)  :  Boolean 

-tsendFlleQ _ 


Figure  20.  The  class  diagram  of  the  Pocket  PC  PFTP  Application  version 
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3.  Activity  Diagram 

Figure  21  shows  the  activity  diagram  for  the  PFTP  application. 


Start  State:  PFTPCIient  started 


Starting  state:  PFTPServer  runs 


Figure  21.  The  activity  diagram  of  the  PFTP  application 
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4.  Flow  Sequence  Diagrams 

The  flow  sequence  diagrams  that  follow  show  the  order  of  the  interactions 
between  the  PFTP  application  objects  during  each  use-case  (mentioned  in  §B.l)  for  both 
versions  of  PFTP  clients  (desktop/laptop  and  Pocket  PC). 


a.  Add  a  File  in  Database 


put(fileSelected) 


Figure  22.  The  sequence  diagram  of  “Add  a  file  in  database”  use-case 
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b. 


Remove  a  File  from  Database 
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c. 


Transfer  a  File 


startCheckTo^ko 

I 

selectServerO 

I 

getServerAvaiableF  ies( ) 
I  I 

new  ObjectlnputStream() 


new  ObjectOutputStrearn() 


newClientHandterO 


new  ObjectInputStreamO 


hew  ObjectOutputStream(j 


openStreamsO 


handleFiteReque'stO 


new  PFTPFieRequesl(fileListOption) 


writeObject(fiteListRequest ) 

I  I  I 


readObjectO 

- H - 

doseConnectionO 

I  I 

askForFile(fileName) 

I  I 

new  ObjectInputStreamO 


I  writeObject(fleList)  I 


doseConnectionO 


Figure  24.  The  sequence  diagram  of  “Transfer  a  file”  use-case 


d. 


Cancel  File  Transfer  and  Save  Partial  Data  Use  Case 


PFTPProtocohiPFTP  Client  User 


Figure  25.  The  sequence  diagram  of  “Cancel  file  transfer  and  save  partial  data”  use  case 
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e. 


Continue  a  Previous  Partial  File  Transfer 


Figure  26.  The  sequence  diagram  of  “Continue  a  previous  partial  file  transfer”  use  case 
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IV.  APPLICATION  DEVELOPMENT 


This  chapter  describes  the  development  tools  used  to  build  the  PFTP  application 
and  some  development  decisions  were  made  during  the  implementation  of  some 
application  components  such  as  the  user  interface  and  the  client-side  and  the  server-side 
programs. 

A.  DEVELOPMENT  TOOLS 

The  PFTP  application  is  written  using  the  Java  programming  language.  For  both 
the  server-side  and  the  laptop  client  version,  the  Java  2  Standard  Edition  (J2SE)  with  the 
Java  Development  Kit  1.4  (JDK  1.4)  was  used.  In  the  Pocket  PC  client  version,  the  Java 
Development  Kit  1.1.8  (JDK  1.1.8)  was  used  because  handheld  and  mobile  devices 
cannot  support  the  functionality  provided  by  greater  versions  of  JDK.  The  Java  code  was 
developed  in  the  JBuilder  9  Java  Editor  environment. 

B.  USER  INTERFACE 
1.  PFTP  Server 

The  server  side  of  the  application  has  a  limited-functionality  user  interface  so  that 
the  user  can  perform  some  basic  operations  such  as  starting  and  stopping  the  PFTP 
server,  and  manipulating  the  database  where  the  files  reside  for  the  clients  to  download. 
Figure  27  shows  the  first  interface  that  the  user  sees  when  the  server  program  runs. 


Figure  27.  User  interface  of  the  PFTP  Server  application 
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There  is  a  menu  bar  with  two  menu  items.  The  Server  menu  item  gives  the  user 
the  ability  to  start  the  server  (start  listening  to  the  assigned  service  port),  stop  the  server, 
or  exit  the  application  (Figure  28). 


Figure  28.  User  interface  when  the  Server  menu  item  is  selected 

If  the  server  is  started  by  the  user,  in  the  main  frame,  a  server  status  panel  appears 
that  shows  how  many  clients  are  connected  to  the  server,  how  many  file  transfers  have 
occurred  since  the  server  started,  how  many  of  the  file  transfers  failed,  and  how  many 
files  are  available  in  the  database  for  download  (Figure  29). 


Figure  29.  User  interface  when  the  server  starts 


The  Database  menu  item  can  be  used  by  the  user  to  update  the  server  file 
database  by  adding  or  removing  files  (Figure  30).  Before  the  user  can  start  the  server,  the 
user  must  first  add  files  to  the  database  to  be  available  for  the  client. 


38 


Figure  30.  User  interface  when  the  Database  menu  item  is  selected 

Selecting  the  add  or  remove  file  option  from  the  Database  menu  item,  the  user  can 
browse  among  the  local  directories  using  a  popup  file  dialog  (Figure  31)  and  select  the 
file  to  add  or  remove  from  the  server  database,  respectively.  The  server’s  file  database 
does  not  store  the  files  as  a  file  objects,  but  rather  as  individual  byte  arrays. 


Figure  3 1 .  User  interface  when  the  Database  menu  item  is  selected 
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PFTP  Client 


Figure  32.  The  user  interface  for  the  client  side  in  the  desktop/laptop  version 


Figure  33.  The  user  interface  for  the  client  side  in  the  desktop/laptop  version 
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c. 


FUNCTIONALITY  IMPLEMENTATION 


1.  File  Transfer  Failure  Recovery 

The  main  functionality  of  the  application  is  to  reconnect  the  client  program  when 
the  connection  is  lost  during  the  file  transfer  process.  The  implementation  for  this  feature 
was  based  on  a  loop  that  the  client  enters  when  a  file  is  requested  from  the  server.  This 
loop  ensures  that  the  client  will  keep  connecting  until  it  gets  the  entire  file.  The  control 
conditions  of  the  loop  are: 

•  The  file  transfer  completion.  If  the  entire  file  is  successfully  transferred 
the  client  exits  the  loop. 

•  The  option  of  the  user  to  cancel  the  file  transfer.  If  the  client  user  decides 
to  do  so,  the  loop  is  ended. 

•  The  number  of  times  the  client  has  already  tried  to  recover  from  the 
connection  loss.  If  this  number  is  greater  than  the  maximum  allowed 
number  of  tries,  the  loop  terminates. 

2.  File  Authentication 

For  the  file  authentication  check  performed  by  the  client  and  the  server,  the 
default  MD5  algorithm  was  used  to  get  the  file  hash  value.  Then  the  hash  value  is 
converted  to  a  string  so  that  it  can  be  easily  exchanged  during  the  communication 
protocol.  Figure  34  shows  the  code  segment  getHashValue()  used  to  produce  the  file  hash 
value. 

*  Compute  the  hash  value  of  a  given  file 

* 

*  @param  fileName  the  name  of  the  file 

*  ©return  the  String  representation  of  the  file  hash  value 

*1 

public  String  getHashValue(  String  fileName  ){ 

String  theHash  =  null; 

try{ 

File  thcFile  =  new  File(  fileName  ); 
fis  =  new  FileInputStream(  theFile  ); 
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byte[]  buffer  =  new  byte[8192]; 
int  length; 

//Select  the  MD5  hash  algorithm 

MessageDigest  md  =  MessageDigest.getInstance(  "MD5" ); 
while(  ( length  =  fis.read(  buffer  ) )  !=  -1  ){ 
md.update(  buffer,  0,  length  ); 

} 

fis.closeO;  //  Close  the  file  stream  to  free  the  file 

//  Final  computation  of  the  hash 
byte[]  hash  =  md.digest(); 

//  Create  a  String  version  of  the  hash  value  using  the  default 
//  64bit  Character  encoding  algorithm. 

BASE64Encoder  encoder  =  new  BASE64Encoder(); 
theHash  =  encoder. encode(  hash  ); 

}  catch(  EileNotEoundException  fnfe  ){ //In  case  file  not  found 
System.out.println(  fnfe ); 
theHash  =  new  String(  "fileNotEound" ); 

}  catch(  Exception  e  ){  //In  case  there  is  problem 
System.out.println(  e  );  //  with  hash  computation 
theHash  =  new  String(  "hashProblem" ); 

} 

return  theHash; 

}  //  end  getHashValueO  method 


Eigure  34.  Code  segment  to  produce  the  file  hash  value 
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V.  TESTING 


This  chapter  describes  to  the  testing  process  of  the  PFTP  application,  including 
the  test  network  description,  the  various  scenarios  that  were  used,  and  the  general  results 
of  the  testing. 


A.  TESTING  NETWORK  DESCRIPTION 

The  testing  of  the  PFTP  application  required  the  installation  of  a  basic  wireless 
network  that  simulates  a  real  situation  in  which  all  the  application  components’ 
operations  can  be  tested  against  several  scenarios. 

1.  Considerations-Limitations 

•  The  NPS  wireless  network  was  used  to  test  the  mobile  PFTP  clients 

•  The  IP  addresses  of  the  PFTP  server  must  be  static. 

•  The  number  of  wired  servers  and  wireless  enabled  devices  used  to  build 
the  test  network,  were  sufficient  to  test  the  requirements  of  the  thesis 
research  and  not  to  test  the  volume  of  client  traffic  that  the  application  can 
handle 

•  In  the  most  of  the  testing  scenarios,  a  “slower”  version  of  the  PFTP  is 
used.  That  means  the  server’s  and  client’s  program  response  was  slowed 
with  the  use  of  a  “delay”  function  so  that  it  is  easier  for  the  user  to  observe 
the  communication  protocol  features  and  behavior  during  the  test 
scenarios. 

•  The  desired  connectivity  failures  necessary  to  test  the  protocol  responses 
were  manually  caused  by  either  unplugging  the  network  connection  in  the 
wired  devices  (mainly  servers),  or  by  disabling  or  removing  the  wireless 
adapters  from  the  wireless  enabled  mobile  client  devices  (laptop, 
PocketPC). 

2.  Testing  Network 

As  Figure  35  shows,  the  testing  network  consists  of  three  PFTP  servers,  each  a 
wired  device,  part  of  the  NPS  network,  one  or  both  wireless  enabled  laptop  and  Pocket 
PC  devices  running  the  appropriate  PFTP  Client  version  software. 
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Figure  35.  The  testing  network  of  PFTP  application 


B.  TESTING  SCENARIOS 

Several  testing  were  developed  to  emulate  the  various  problems  that  might  be 
encountered  by  a  wireless  device  while  downloading  a  large  file.  These  scenarios  assured 
that  the  purposes  of  the  thesis  research  were  fulfilled.  Table  2  lists  all  the  testing 
scenarios  associating  them  with  a  reference  code  so  that  they  can  be  referred  to  the  results 
description  without  naming  them  explicitly.  The  reference  codes  start  with  a  group  of 
letters  that  indicates  the  general  scenario  type  and  ends  with  a  counter  number.  The 
reference  code  part  that  refers  to  the  scenario’s  type  is  one  of  the  following: 

•  SUIS:  Server  User  Interface  Scenario.  Situations  that  can  happen  during 
the  interaction  of  the  PFTP  Server’s  user  with  the  available  user  interface. 

•  CUIS:  Client  User  Interface  Scenario.  Situations  that  can  happen  during 
the  interaction  of  the  PFTP  Client’s  user  with  the  available  user  interface. 

•  CPS:  Communication  Protocol  Scenario.  Situations  that  can  happen 
during  the  communication  between  the  client  and  the  server. 
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Scenario  Reference  Code 

Scenario’s  description 

SUIS-1 

Starting  the  server  without  adding  files  in  the  database 

SUIS-2 

Trying  to  remove  a  file  from  the  database  when  it  is  empty 

SUIS-3 

Entering  the  same  file  twice  into  the  database 

CUIS-1 

Selecting  to  continue  a  previously  failed  file  transfers  when 

one  is  not  an  associated  file  saved 

CUIS-2 

Trying  to  download  a  file  without  selecting  all  the  necessary 

file  transfer  options 

CPS-1 

The  PFTP  server  is  not  reachable  when  the  available  files  are 

requested  and  the  single  server  mode  is  selected 

CPS-2 

The  PFTP  server  is  not  reachable  when  the  available  files  are 

requested  and  the  auto  server  mode  is  selected 

CPS-3 

During  the  file  transfer,  the  connection  is  lost  but  is  restored 

again  after  a  short  period  of  time.  The  single  server  mode  is 

selected. 

CPS-4 

During  the  file  transfer,  the  connection  is  lost  but  is  restored 

again  after  a  short  period  of  time.  The  auto  server  mode  is 

selected. 

CPS-5 

During  the  file  transfer,  the  connection  is  lost  but  is  restored 

again  after  some  period  of  time.  The  auto  server  mode  is 

selected  and  all  the  other  servers  except  the  first  one  selected, 

have  the  same  named  file  but  contain  different  content. 

Table  2.  The  testing  scenarios  for  the  PFTP  application 
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If  the  server  has  been  started  by  the  user,  the  main  frame  of  the  server’s  status 
panel  appears  in  that  shows  how  many  clients  are  connected  to  the  server,  how  many  file 
transfers  have  occurred  since  the  server  started,  how  many  of  the  file  transfers  failed,  and 
how  many  files  are  available  in  the  database  for  download  (Figure  3). 

C.  TESTING  RESULTS 

The  following  paragraphs  explain  how  the  network  components  responded  to 
each  of  the  scenarios  and  how  the  user  interface  helped  the  user  be  informed  if  a  file 
transfer  failed  during  its  operation.  The  reference  codes  listed  in  Table  1  are  used  to  refer 
to  each  scenario. 

•  SUIS-1.  The  scenario  tries  to  determine  if  the  PFTP  server  starts  listening 
to  the  assigned  port  without  having  any  files  available  for  the  clients  to 
download.  The  result  was  that  the  program  informed  the  user  via  a 
message  to  add  at  least  one  file  to  the  server’s  file  database  such  that  the 
server  has  a  reason  to  start  listening  for  clients  (Figure  2). 


□ 


Figure  36.  The  response  of  server  side  in  the  SUIS-1  scenario 


SUIS-2.  The  same  situation  as  the  previous  but  this  time  tested  function  is 
an  attempt  to  remove  a  file  from  the  empty  database.  When  the  database  is 
empty,  the  selection  of  the  user  to  remove  a  file  caused  a  message  to 
appear  informing  the  user  about  the  database’s  status  (Figure  37). 
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^  Ql^iS 

Server  Database 


Figure  37.  The  response  of  server  side  in  the  SUIS-2  scenario 

SUIS-3.  Trying  to  add  a  file  to  the  file  database  that  has  the  same  filename 
as  an  existing  one,  is  another  tested  case.  In  this  scenario,  the  response  of 
the  server  program  was  to  ask  the  user  to  choose  between  replacing  the 
existing  file  with  the  new  one  or  leaving  the  old  file  in  the  database 
(Figure  38). 


S  -  in;a 

Server  Database 


Figure  38.  The  message  when  a  already  existing  file  is  added  in  file  database 


CUIS-1.  The  user  interface  gives  the  user  the  ability  to  select  to  continue  a 
previously  failed  file  transfer,  saving  the  partial  data  to  a  form  in  the 
database.  However,  when  no  failed  transfers  have  occurred,  the  selection 
of  the  previous  file  retrieval  mode  causes  the  system  to  respond  with  a 
message  that  states  this  (Figures  39  and  40). 
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0  Previous  failures 


OPFTP  Server  files 


m: 


Q  Manual  Selection 


0  Existing  Servers 


_ m 

No  file  transfer  failure  by  now! 

Select  a  file  from  the  PFTP  servers. 


Figure  39.  The  message  when  no  previous  partial  file  transfer  exists 


PFTP  PocketPC  1.0 
CONTROL  PANEL 
Fie  to  retreive;  £ 


Message 


FTI 


Failed  transfers 


No  file  transfer  failure  by  now! 


File  selected  : 


I  P.bcryv-;  flJ-)-;. 

No  file  selected 


Download  |  DaocbJ  Dov/oIcj-jcI 
^|pFTP  PocketPC  :  H  '  9:10 


Figure  40.  The  same  message  as  Figure  5  in  Pocket  PC  device 


CUIS-2.  In  this  scenario,  the  user  presses  the  download  button,  without 
first  selecting  all  the  transfer  options  such  as  the  file  name,  the  server,  or 
the  packet  size.  The  system  informs  the  user  to  do  so  (Figures  41  and  42). 
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Figure  41.  The  message  when  not  all  the  file  transfer  option  are  selected 


Figure  42. 


PFTP  PocketPC  1.0  H  H  Q 

CONTROL  PANEL 

File  to  retreive:  BB  Failed  transfers 
mm^^Files  on  server 
♦♦  INFORMATION  **  Q 

Select  file  and  packet  size! 


OK 

I  i-.acrajv-;  snaa.. 

File  selected  :  No  file  selected 

i  Download  |  C-jncai  Dov/oluacl 

^IpFTP  PocketPC  :  H  ’  9:42 


The  same  message  as  Figure  7  in  Pocket  PC  environment 


CPS-3.  This  is  the  main  function  of  the  PFTP  application -recovering  from 
a  failed  connection.  During  the  file  transfer,  the  connection  is  interrupted 
and  the  client  attempts  to  the  server  in  either  single  and  or  manually 
selected  server  mode.  The  image  progress  panel  of  the  user  interface, 
which  displays  the  image  download  progress,  stops  updating  until  the 
client  reconnects  to  the  server  and  begins  retrieval  of  the  rest  of  the  file. 
Figures  43  and  44  show  the  paused  state  of  the  user  interface  during 
connection  failure  and  Figure  45  the  attempt  of  the  client  program  to 
connect  to  the  server.  Figures  46  and  47  show  the  message  when  the  file  is 
finally  transferred,  followed  by  the  amount  of  time  the  transfer  required. 
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Figure  43.  Paused  state  of  the  user  interface  after  a  connection  loss  (laptop) 


Figure  44.  Paused  state  of  the  user  interface  after  a  connection  loss  (Pocket  PC) 
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Bytes  8193  to  8448  received 
Bytes  8449  to  8704  received 
Problem  reading  I/O  Streams 
Transfer  cancelled! 

Trying  to  connect  t( 
Transfer  cancelled! 

Trying  to  connect  t( 
Transfer  cancelled! 

Trying  to  connect  t< 
Transfer  cancelled! 

Trying  to  connect  t( 
Transfer  cancelled! 

Trying  to  connect  t( 
Transfer  cancelled! 

Trying  to  connect  t( 

Client  connected! 

File  size  to  receiv( 

Bytes  8705  to  8960  received 
Bytes  8961  to  9216  received 


the 

server. . . 

,  .169.254.1.190 

the 

server. . . 

,  .169.254.1.190 

the 

server. . . 

.  .169.254.1.190 

the 

server. . . 

,  .169.254.1.190 

the 

server. . . 

,  .169.254.1.190 

the 

server. . . 

.  .169.254.1.190 

11719  bytes 

Figure  45.  The  system  output  that  shows  the  reeonneetion  proeedure 


Figure  46.  The  user  interface  when  the  file  is  transfer  is  completed  in  the  laptop  version 
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Figure  47.  The  user  interface  when  the  file  transfer  is  completed  in  the  Pocket  PC  version 


CPS-4.  The  difference  between  this  scenario  and  that  of  CPS-3  is  that  the 
server  mode  is  auto  mode.  When  the  connection  is  lost,  the  client 
randomly  picks  a  server  randomly  from  the  valid  server  list  and  tries  to 
that  server.  Figure  48  shows  the  system  output  of  the  client  trying  to 
connect  to  the  valid  servers.  Hopefully,  it  finds  a  server  to  continue  the 
partial  file  transfer. 
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Bytes  257  to  320  received 
Bytes  321  to  384  received 
Bytes  385  to  448  received 
Problem  reading  I/O  Streams 
Connection  failed! 

auto  select  next  server. ...  131. 120. 49. 173 
Trying  to  connect  to  the  server ....  131. 120. 49. 173 
Connection  failed! 

auto  select  next  server ....  131. 120. 49. 171 
Trying  to  connect  to  the  server ....  131. 120. 49. 171 
Connection  failed! 

auto  select  next  server. ...  131. 120. 49. 173 
Trying  to  connect  to  the  server ....  131. 120. 49. 173 
Connection  failed! 

auto  select  next  server. ...  131. 120. 49. 174 
Trying  to  connect  to  the  server ....  131. 120. 49. 174 
Connection  failed! 

auto  select  next  server ....  131. 120. 49. 171 
Trying  to  connect  to  the  server ....  131. 120. 49. 171 
Connection  failed! 

auto  select  next  server ....  131. 120. 49. 174 
Trying  to  connect  to  the  server ....  131. 120. 49. 174 
Connection  failed! 

auto  select  next  server ....  131. 120. 49. 171 
Trying  to  connect  to  the  server ....  131. 120. 49. 171 
Connection  failed! 

auto  select  next  server ....  127. 0. 0. 1 

Trying  to  connect  to  the  server _ .127.0.0.1 

Client  connected! 

File  size  to  receive  13310  bytes 
Bytes  449  to  512  received 

Rvt.ps  1".n  rprpiTJprt 

Figure  48.  Auto  server  search  after  a  connection  loss  in  auto  server  mode 

•  CPS-5.  This  last  scenario  tested  the  response  of  the  client  when,  after  a 
connection  loss,  it  finds  a  server  that  has  a  file  with  the  same  name  but  a 
different  file  hash  value.  In  that  case,  the  server  sent  a  response  that 
informed  the  client  that  the  file  version  in  its  database  is  not  the  requested 
one. 
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VI.  CONCLUSIONS  AND  FUTURE  WORK 


A.  SUMMARY 

The  potential  goal  of  this  thesis  research  was  to  model  an  upper-layer 
communication  protocol  that  can  preserve  file  transfer  sessions  in  a  highly  mobile 
environment,  and  implement  an  application  that  use  and  demonstrates  the  operation  of 
this  protocol.  As  a  background  research,  all  the  well-known  file  transfer  protocols  were 
examined  in  aspect  of  their  communication  protocol  characteristics  and  if  there  is  any 
feature  that  can  be  used  to  achieve  a  partial  file  transfer  after  a  connection  failure. 

The  communication  protocol  that  was  designed  is  a  client-server-type  protocol 
that  supports  client  multithreading  in  server-side  and  can  dynamically  recover  from  a  file 
transfer  failure.  This  partial  file  recovery  feature  is  achieved  by  designing  and  implement 
the  client-side  program  to  keep  attempting  several  times  asking  the  server  for  the  part  of 
the  file  was  not  received  when  a  connection  failure  occurs. 

Also,  the  PFTP  application  was  developed  to  use  this  protocol  and  make  user  able 
to  interact  with  protocol  and  the  file  transfer  features.  User  interface  was  designed  so  that 
the  dynamic  partial  file  retrieval  and  the  can  be  visible  to  the  use  at  real  time.  In  order  to 
make  this  function  possible,  special  panels  created  on  the  user  interface  that  show  the  file 
transfer  progress  and  displays  the  partial  file  data  received 

The  communication  protocol  and  the  PFTP  application  tested  against  several 
scenarios.  The  main  situation  that  the  protocol  behavior  was  tested  was  when  during  the 
file  transfer  the  connection  failed  that  caused  the  client  program  retry  successfully 
reconnecting  when  in  a  reasonable  time  the  connection  was  restored.  PFTP  application 
also  tested  in  the  file  management  on  the  server  and  the  multithreaded  behavior.  The 
client  side  in  both  laptop  and  Pocket  PC  versions  tested  successfully  in  visualizing  the 
file  transfer  progress  and  in  controlling  the  file  transfer  options  (file  request,  canceling 
the  downloading,  or  choosing  to  continue  previous  failed  file  transfers). 
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B.  FURTHER  WORK 


Extending  the  researeh  scope  of  this  thesis  and  the  application  developed  in 
support  of  it,  there  are  issues  that  raise  opportunities  for  further  research.  These  include: 


1.  Communication  Protocol  Design 

Using  as  a  model  the  PFTP  client-server  communication  protocol,  more  research 
could  be  focused  on  enhancing  specific  aspect  of  the  protocol  it  self  and  how  its 
operation  can  be  improved.  Some  key  areas  towards  this  direction  could  be: 

•  Multiple  types  of  session  content.  Further  enhancement  in  the  protocol  can 
be  done,  so  various  types  of  sessions  (e.g.  steaming  media,  interactive 
connection,  etc.)  can  be  supported  instead  of  just  file  transfers. 

•  Use  of  UDP  protocol.  The  PFTP  communication  model  uses  TCP  as  the 
underlying  protocol  in  the  data  transfer  connection.  It  would  be  useful 
implementing  the  same  application  using  the  UDP  protocol,  and 
comparing  the  performance  of  the  two  implementations  with  respect  to 
data  session  survivability  in  a  wireless  environment. 

•  PFTP  server  locator.  Additional  feature  of  the  application  develop  a 
content/server  location  protocol  that  will  automatic  discover  server  to  re¬ 
establish  sessions  instead  of  current  manual  insertion  of  servers. 


2.  Application  Development 

In  application  development  the  following  further  work  can  be  done: 

•  Extension  the  API  class  library.  Create  a  class  or  library  API  for  the 
persistent  connection  protocol  that  application  developers  can  use  to 
develop  new  applications. 

•  Use  persistent  data  sessions.  Examine  applying  the  persistent  data  sessions 
in  other  type  of  application  where  can  be  useful. 
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APPENDIX.  CLASS  SOURCE  CODE 


//packages  for  network  components 
import  java.io.*; 
importjava.net.*; 

//packages  for  user  interface  components 

import  j  ava .  awt.  * ; 

import  java. awt. event.*; 

import  java.util.*; 

import  j avax .swing . * ; 

import  javax.swing.text.*; 

import  javax.swing.SwingUtilities; 

//package  for  security  components 
import  j  ava.  security .  * ; 

//package  for  character  encoding  components 
import  sun.misc.*; 

*  File  PFTPClient.java 

* 

*  This  is  a  FTP  Client  of  the  application 

* 

*  This  client  ask  for  a  file  and  stays  in  a  loop  keep  asking 

*  until  it  gets  it  all.  In  the  first  request  it  receives  the 

*  hash  value  of  the  requested  file  so  when  the  connection  is 

*  lost  client  can  ask  an  other  server  the  same  file  with  out 

*  worrying  about  the  authenticity  of  it. 

* 

*  ©author  LT  Peri k1  is  Pantoleon 

*  ©version  1.0 
*/ 

class  PFTPClient  extends  JFrame{ 

// 

// 

//  Private  Data  Members: 

// 

// 

/**  The  default  port  where  the  FTP  client  is  asking  the  server  */ 
private  static  final  int  FTP_PORT  =  6789; 
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/**  The  string  array  with  the  valid  servers  can  be  chosen  */ 
private  static  final  String[]  VALID_SERVERS  =  { 

"131.120.105.237",  "131.120.105.250",  "131.120.201.46",  "127.0.0.1"}; 

/**  The  packet  size  array  with  the  packet  sizes  can  be  chosen  */ 
private  String[]  PACKET_SIZES  =  {new  String}  "32" ), 
new  String}  "64" ),  new  String}  "128" ), 
new  String}  "256" ),  new  String}  "512" ), 
new  String}  "1024")}; 

/**  The  connected  status  */ 

private  static  final  String  CONNECTED  =  "Connected"; 

/**  The  disconnected  status  */ 

private  static  final  String  DISCONNECTED  =  "Disconnected"; 

/**  The  status  when  the  client  is  trying  to  connect  */ 

private  static  final  String  TRYING_TO_CONNECT  =  "Trying  to  connect . "; 

/**  The  timeout  period  of  the  TCP  sockets  */ 
private  static  final  int  SO_TIME_OUT  =  3000; 

/**  The  length  in  bytes  of  the  file  hash  value  */ 
private  static  final  int  MD5_HASH_EENGTH  =  16; 

/**  The  font  size  for  the  panels'  titles  */ 

private  static  final  int  PANEE_TITEE_PONT_SIZE  =  17; 

/**  The  font  size  for  the  panels'  labels  */ 

private  static  final  int  PANEE_EABEE_PONT_SIZE  =13; 

/**  The  panels'  font  color  */ 

private  static  final  Color  PONT_COEOR  =  Color. white; 

/**  The  color  of  the  background  of  the  frames  and  panels  */ 

private  static  final  Color  BACKGROUND_COEOR  =  new  Color}  77,  92,  240  ); 

/**  The  color  of  the  panels'  border  */ 

private  static  final  Color  PANEE_BORDER_COEOR  =  Color.blue; 

/**  The  maximum  reconnection  tries  each  time  client  lose  connection*/ 
private  static  final  int  MAX_RECONNECTION_TRIES  =  3; 

/**  The  maximum  reconnection  tries  each  time  client  lose  connection  */ 
private  static  final  int  MAX_TOTAE_TRIES  =  3; 
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/**  The  times  that  the  image  is  updated  in  the  image  progress  panel  */ 
private  static  final  int  IMAGE_UPDATE_TIMES  =  10; 

/**  The  request  type  when  a  file  is  asked  */ 
private  static  final  int  EIEE_REQUEST_TYPE  =  1 ; 

/**  The  request  type  when  a  file  array  is  asked  */ 

private  static  final  int  PIEE_ARRAY_REQUEST_TYPE  =  0; 

/**  The  file  name  of  the  logo  image  of  the  client  frame  */ 
private  static  final  String  EOGO_IMAGE  =  "pftpEogoClient.gif"; 

// 

// 

//  Data  Members  for  the  ETP  Client  functionality: 

// 

// 

/**  The  socket  client  use  to  communicate  with  the  server  */ 
private  Socket  clientSocket; 

/**  The  object  input  stream  to  receive  objects  from  client  */ 
private  ObjectInputStream  inObjectPromServer; 

/**  The  object  output  stream  to  send  objects  to  client  */ 
private  ObjectOutputStream  outObjectToServer; 

/**  The  file  request  received  from  client  */ 
private  PETPEileRequest  fileRequest; 

/**  The  map  that  store  that  old  partial  file  bytes  */ 
private  HashMap  oldPartialTransferRequests; 

/**  The  map  that  store  that  old  partial  file  bytes  */ 
private  HashMap  oldPartialTransfersBytes; 

/**  The  array  of  the  file  names  that  failed  to  downloaded  */ 
private  Array Eist  oldPartialTransfersEiles; 

/*  The  array  list  of  the  files  available  on  PETP  server  */ 
private  ArrayEist  serverAvailableEiles; 

/**  The  name  of  the  asked  file  */ 
private  String  fileNameToAsk; 

/**  The  server  mode  selected  */ 
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private  String  serverMode; 

/**  The  server  selected  */ 
private  String  serverSelected; 

/**  The  hash  value  of  the  file  asked  */ 
private  String  fileHash; 

/**  The  size  in  bytes  of  the  file  asked  */ 
private  int  fileSize; 

/**  The  offset  from  where  we  need  the  file  */ 
private  int  offset; 

/**  The  packet  size  used  for  the  file  transfer  */ 
private  int  packetSize; 

/**  The  file  as  a  byte  array  */ 
private  byte[]  fileluBytes; 

/**  The  packet  counter  */ 
private  int  packetCounter; 

/**  The  number  of  packets  used  for  the  file*/ 
private  int  numOfPackets; 

/**  The  start  time  of  the  file  reception  */ 
private  long  startTime; 

/**  The  end  time  of  the  file  reception  */ 
private  long  stopTime; 

/**  The  total  file  transfer  time  */ 
private  long  totalFileTransferTime; 

/**  The  connection  status  */ 
private  String  connectionStatus; 

/**  The  connection  loss  times  */ 
private  int  connectionLossTimes; 

/**  The  boolean  value  of  the  intetion  of  the  user  to  ask  a  file  */ 
private  boolean  wantFile; 

/**  The  boolean  value  if  the  file  is  transfered  or  not  */ 
private  boolean  fileTransfered; 
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/**  The  boolean  value  the  file  transfer  is  canceled  or  not  */ 
private  boolean  cancelFileTransfer; 

/**  The  boolean  value  if  a  file  selected  or  not  */ 
private  boolean  retrieveFailedTransfers; 

/**  The  boolean  value  of  the  intention  of  the  user  to  ask  a  file  */ 
private  String  partialRetreivedFileName; 

// 

// 

//  Data  Members  for  the  User  Interface: 

// 

// 

/**  The  container  of  the  main  frame  */ 
private  Container  container; 

/**  The  layout  manager  of  the  container  */ 
private  GridBagLayout  layout; 

/**  The  GridBagConstraints  variable  of  the  layout  manager*/ 
private  GridBagConstraints  constraints; 

/**  The  control  panel  */ 
private  ControlPanel  controlPanel; 

/**  The  panel  that  shows  the  transfer  progress  */ 
private  TransferProgressPanel  transferProgressPanel; 

/**  The  panel  that  shows  the  transfer  status  during  downloading  */ 
private  TransferStatusPanel  transferStatusPanel; 

/**  The  panel  that  displays  the  image  during  the  downloading  */ 
private  ImageProgressPanel  imageProgressPanel; 

/**  The  boolean  tranfering  status  */ 
private  boolean  filelsTransfering; 

/**  The  boolean  value  if  user  want  to  download  the  file  or  not  */ 
private  boolean  askTheFile; 

// 

// 

//  Constructor: 
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// 

//■ 


*  Default  constructor 
*1 

public  PFTPClientO  { 

super(  "PFTP  Laptop  1.0" ); 

//  get  content  pane 
container  =  getContentPane(); 

//  instantiate  gridbag  constraints 
constraints  =  new  GridBagConstraints(); 

//  create  the  panels 

transferProgressPanel  =  new  TransferProgressPanel(  this  ); 
transfers tatusPanel  =  new  Transfers tatusPanel(  this  ); 
imageProgressPanel  =  new  ImageProgressPanel(  this  ); 
controlPanel  =  new  ControlPanel(  this,  transferProgressPanel, 
transferStatusPanel, 
imageProgressPanel ); 

//  set  the  layout  of  the  container 
layout  =  new  GridBagLayout(); 
container.  setLayout(  layout ); 

//  add  the  panels  on  the  main  frame's  panels 
//constraints.weightx  =  1; 

//constraints,  weighty  =  1; 

constraints. fill  =  GridBagConstraints.BOTH; 

addPanel(  controlPanel,  0,  0,  1,4); 

//constraints.weightx  =  1; 

//constraints,  weighty  =  1; 

constraints. fill  =  GridBagConstraints.BOTH; 

addPanel(  transferProgressPanel,  4,  0,  1,  1  ); 

//constraints.weightx  =  1; 

//constraints,  weighty  =  1; 

constraints. fill  =  GridBagConstraints.BOTH; 

addPanel(  transferStatusPanel,  5,  0,  1,3); 

constraints.weightx  =  1; 
constraints,  weighty  =  1; 
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constraints. fill  =  GridBagConstraints.BOTH; 

addPanel(  new  JScrollPane(  imageProgressPanel ),  0,  1,  1,8); 

//sets  other  attributes  of  the  main  frame 
setSize(  700,  500 ); 
setLocation(  50,  100 ); 
setVisible(  true ); 

setExtendedState(  JFrame.MAXIMIZED_BOTH ); 
setResizable(  true ); 

setDefaultCloseOperation(  JErame.EXIT_ON_CEOSE ); 

//initialization  of  the  private  members 
oldPartialTransferRequests  =  new  HashMapO; 
oldPartialTransfersBytes  =  new  HashMapO; 
oldPartialTransfersEiles  =  new  Array Eist(); 
server AvailableEiles  =  new  Array Eist(); 

fileluBytes  =  null; 
fileNameToAsk  =  null; 
fileSize  =  0; 
packetSize  =  0; 
fileHash  =  ""; 

connectionStatus  =  DISCONNECTED; 
connectionEossTimes  =  0; 
totalEileTransferTime  =  0; 
retrieveEailedTransfers  =  false; 
filelsTransfering  =  false; 
askTheEile  =  false; 

}  //  end  default  constructor 

*  Add  a  component  using  the  GridBagEayout 

* 

*  @param  component  the  component  to  add 

*  @param  row  the  row  to  add  the  component 

*  @param  column  the  column  to  add  the  component 

*  @param  width  the  width  in  columns  of  the  component 

*  @param  height  the  heigth  in  rows  of  the  component 
*/ 

private  void  addPanel(  Component  component, 

int  row,  int  column,  int  width,  int  height ){ 
constraints.gridx  =  column; 
constraints. gridy  =  row; 
constraints.gridwidth  =  width; 
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constraints. gridheight  =  height; 

//  set  constraints  and  add  component 
layout.setConstraints(  component,  constraints  ); 
container.  add(  component ); 

}  //end  addPanelO  method 

*  Adds  a  panel  to  a  container 

* 

*  @param  container  the  container  to  add  the  panel 
*1 

public  void  addPanel(  Container  container  )  { 

JPanel  dummy  =  new  JPanel(); 

dummy. setBackground(  BACKGROUND_COLOR ); 

container.  add(  dummy ); 

}  //end  addPanelO  method 

*  Opens  the  streams  for  communicating  with  the  client 

* 

*  ©throws  lOException  when  the  outpu/input  stream  can  not  be  openned 
*/ 

private  void  openStreams()  throws  lOException { 

//  open  the  sreams  needed 

inObjectEromServer  =  new  ObjectInputStream(  clientSocket.getInputStream() ); 
outObjectToServer  =  new  ObjectOutputStream(  clientSocket.getOutputStream() ); 

}  //  end  openStreamsO  method 

/** 

*  Selects  one  from  the  valid  server  to  try  connecting 

* 

*  ©return  a  string  IP  address  of  the  server 
*1 

private  String  selectServer()  { 

String  serverToReturn; 

double  random  =  10  *  Math.random(); 

int  randomindex  =  ( int )  random; 

serverToReturn  =  VAEID_SERVERS [randomindex  %  VAEID_SERVERS. length]; 
return  serverToReturn; 

}  //  end  selectServerO  method 
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*  Selects  one  from  the  valid  server  to  try  connecting 

* 

*  ©return  a  string  IP  address  of  the  server 

*  ©throws  lOException  if  the  input/output  streams  fail 

*  ©throws  ClassNotFoundException  if  the  received  object  is  not  of  a  known  class 

*1 

private  ArrayEist  getServerAvailableFiles()  throws  lOException, 
ClassNotFoundException  { 

boolean  exit  =  false; 
boolean  connected  =  false; 
int  serverindex  =  0; 

if(  serverMode  ==  "Auto  select" ){ 

while(  ! connected  &&  (  serverindex  <  VAEID_SER VERS. length  ) ){ 
serverSelected  =  VAEID_SER  VERS  [serverindex]; 

System.out.println(  "server  :  "  +  serverSelected  ); 

serverlndex++; 

try] 

clientSocket  =  new  Socket]  serverSelected,  FTP_PORT  ); 
connected  =  true; 

}  catch]  lOException  ioe  )  { 

}  //end  try  catch  block 
}  //end  while 
if]  !  connected ){ 

clientSocket  =  new  Socket]  serverSelected,  FTP_PORT  ); 

} 

}  else] 

clientSocket  =  new  Socket]  serverMode,  FTP_PORT  ); 

} 

openStreams]); 

connectionStatus  =  CONNECTED; 
transferStatusPanel.updateFileTransferStatus]); 

fileRequest  =  new  PFTPFileRequest]  FIEE_ARRAY_REQUEST_TYPE, 
new  String]), 
new  String]), 

0, 

0); 

//send  the  file  request  object  to  the  server 
outObjectToServer.writeObject]  fileRequest ); 
outObjectToServer  .flush]) ; 

Vector  filesAtServer  =  ]  Vector )  inObjectFromServer.readObject]); 
server AvailableFiles  =  new  ArrayEist]); 
for]  int  i  =  0;  i  <  filesAtServer.size]);  i++  )] 
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server AvailableFiles.add(  files AtServer.elementAt(  i ) ); 

} 

System.out.println(  "Files  at  server  :  "  +  server AvailableFiles  ); 
clientSocket.closeO; 

connectionStatus  =  DISCONNECTED; 
transferStatusPanel.updateEileTransferStatusO; 

return  serverAvailableEiles; 

}  //  end  selectServerO  method 

*  Sends  a  file  request  package  to  the  server  asking  for  a  file 

* 

*  @param  fileRequest  the  file  request 

*  ©throws  Exception 
*1 

public  void  askEorEile(  PETPEileRequest  fileRequest )  throws  Exception  { 

//  some  variable  initialization 
boolean  fileNotEound  =  false; 
fileTransfered  =  false; 
cancelEileTransfer  =  false; 
packetCounter  =  0; 
int  byteCounter  =  0; 
int  numOfBytes  =  1; 
int  percent  =  0; 
numOfPackets  =  1 ; 

fileNameToAsk  =  fileRequest.getEile(); 
boolean  firstiteration  =  true; 

//  create  a  file  to  receive 

Eile  file  =  new  Eile(  fileNameToAsk  ); 

int  connectionCounter  =  1 ; 

int  imagePacketUpdate  =  0; 

int  imagePacketUpdateCounter  =  1 ; 

//update  the  file  status  panel 
transferStatusPanel.updatePileTransferStatusO; 

if(  retrievePailedTransfers  )  { 
offset  =  fileRequest.getOffsetO; 
fileHash  =  fileRequest.getHash(); 
packetCounter  =  offset; 
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numOlPackets  =  packetCounter  +  1 ; 
}  //end  if 


//  The  loop  that  keep  asking  the  file  till  gets  it  all 

while(  !cancelFileTransfer  &&  IfileTransfered  &&  !fileNotFound  && 

( packetCounter  <  numOfPackets )  && 

(  connectionCounter  <=  (  MAX_RECONNECTION_TRIES  * 

MAX_TOTAE_TRIES  ) ) ){ 

if(  (  (  MAX_RECONNECTION_TRIES  *  MAX_TOTAE_TRIES  )  % 

connectionCounter )  == 

1){ 

delay/  2000 ); 

}  else{ 

delay/  2000 ); 

}  //end  if  else 
connectionCounter++ ; 

try{ 

if/  serverMode. equals/  new  String/  "Auto  select" ) ) ){ 

//select  a  valid  server  to  try  connect 
if/  !firstIteration ){ 

serverSelected  =  selectServer/); 


} 

}  else/ 

serverSelected  =  serverMode; 

}  //end  if 

System.out.println/  "Trying  to  connect  to  the  server...."  + 
serverSelected ); 
delay/  2000 ); 

//connect  to  the  server  selected  and  set  the  time  out  period 
clientSocket  =  new  Socket/  serverSelected,  ETP_PORT  ); 
clientSocket.setSoTimeout/  SO_TIME_OUT ); 

connectionStatus  =  CONNECTED; 
transferStatusPanel.updateEileTransferStatus/); 

System.out.println/  "Client  connected!" ); 

try{ 
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openStreamsO; 

}  catch(  Exception  ioe  )  { 

JOptionPane.showMessageDialog(  null,  "Client:  Failed  to  open  streams", 
"Exception", 

JOptionPane.ERROR_MESSAGE,  null ); 

}  //  end  try  catch  block 

fileRequest.setOffset(  offset ); 
fileRequest.setHash(  fileHash ); 

//send  the  file  request  object  to  the  server 
outObjectToServer.writeObject(  fileRequest ); 
outObjectToServer.flushO; 

//receive  the  file  hash  value  if  it  is  asked  for  the  first  time 
fileHash  =  inObjectFromServer.readUTF(); 

System.out.println(  "Hash  value  received  "  +  fileHash  ); 

if(  !fileHash.equals(  new  String(  "fileNotFound" ) )  && 

!fileHash.equals(  new  String(  "hashProblem" ) )  && 

!fileHash.equals(  new  String(  "fileNotMatch" ) ) ){ 

//receive  the  file  size  from  the  server 
fileSize  =  inObjectFromServer.readInt(); 

System.out.println(  "File  size  to  receive  "  +  fileSize  +  "  bytes" ); 
numOfPackets  =  (  fileSize  /  packetSize  )  +  1 ; 

imagePacketUpdate  =  numOfPackets  /  ( IMAGE_UPDATE_TIMES  -  1 ); 

//update  the  transfer  status  panel 

transfers  tatusPanel.updateFileTransferStatusO; 

if(  packetCounter  ==  0  )  { 

//initialize  a  byte  array  for  the  file  bytes 
fileInBytes  =  new  byte[fileSize  +  packetSize]; 

}  else  if(  retrieveFailedTransfers  &&  firstiteration  ){ 
firstiteration  =  false; 

byte[]  partialBytes  =  (  byte[]  )  oldPartialTransfersBytes.get( 
fileNameToAsk ); 

ByteArrayOutputStream  baos  = 

new  ByteArrayOutputStream(  fileSize  +  packetSize  ); 
baos.write(  partialBytes,  0,  partialBytes. length  ); 
fileInBytes  =  baos.toByteArrayO; 
baos.closeO; 
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byteCounter  =  packetSize  *  offset; 

}  //end  if  else  if 

byte[]  newPacket  =  new  byte  [packetSize]; 
try] 

if(  packetCounter  ==  0  )  { 
startTime  =  System.currentTimeMillis(); 

}  //end  if 

filelsTransfering  =  true; 

//sets  the  maximum  of  the  transfer  progress  bar 
transferProgressPanel.setProgressBarMax(  numOfPackets ); 

try] 

//receiving  the  packets  and  updating  the  file  byte  array 
while(  IcancelFileTransfer  &&  (  packetCounter  <  numOfPackets ) )]  //end  if 
offset  =  packetCounter; 
inObjectFromServer.read(  newPacket ); 

transferProgressPanel.updateProgressBar(  packetCounter ); 

for(  int  i  =  0;  i  <  packetSize;  i++  )] 
fileluBytes  [byteCounter  +  i]  =  newPacket]i]; 

}  //end  for  loop 

System.out.println(  "Bytes  "  +  (  byteCounter  +  1  )  + 

"  to  "  +  ( byteCounter  +  packetSize  )  + 

"  received" ); 

if(  ( packetCounter  %  imagePacketUpdate  )  ==  0  )  ] 

//update  image  progress  panel 

imageProgressPanel.updateImageProgress(  fileluBytes ); 

}  //and  if 

totalFileTransferTime  =  System.currentTimeMillis()  -  startTime; 
delay]  500 ); 

byteCounter  +=  packetSize; 
packetCounter++ ; 

}  //end  while  loop 

}  catch]  NullPointerException  npe  )] 

System.out.println]  "Problem  with  null  pointers" ); 

} 

//renews  the  maximum  of  the  transfer  progress  bar 
transferProgressPanel.setProgressBarMax]  numOfPackets  -  1 ); 

}  catch]  lOException  ioe  )]  //in  case  of  connection  loss 
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System.out.println(  "Problem  reading  I/O  Streams"  ); 
connectionStatus  =  DISCONNECTED; 
connectionEossTimes++; 
transferStatusPanel.updateEileTransferStatusO; 

}  //end  try  catch  block 

stopTime  =  System.currentTimeMillis(); 

//create  the  file  and  pass  the  byte  array  formed  in  it 
if(  !cancelPileTransfer  &&  packetCounter  ==  numOfPackets ){ 
fileTransfered  =  true; 
outObjectToServer.writeBoolean(  true ); 
outObjectToServer.flushO ; 
if(  !file.createNewPile() ){ 
file.deleteO; 

}  //end  if 

file  =  new  Pile(  fileNameToAsk  ); 
file.createNewEileO; 

EileOutputStream  editPile  =  new  EileOutputStream(  file  ); 
editEile.write(  fileInBytes  ); 

totalEileTransferTime  =  stopTime  -  startTime; 

editPile. closeO; 
if(  retrievePailedTransfers  ){ 
deletePartialPileRequest(  fileNameToAsk ); 
retrievePailedTransfers  =  false; 
deletePartialPileRequest(  fileNameToAsk ); 

}  //end  if 

transferProgressPanel.updateProgressBar(  packetCounter  -  1  ); 
transferStatusPanel.updatePileTransferStatusO; 
imageProgressPanel.updateImageProgress(  fileInBytes ); 
imageProgressPanel.updateImageProgress(  fileInBytes ); 

J OptionPane .  showMess ageDialog(  null, 

"Pile  successfully  transfered  in\n"  + 

It  It 

totalEileTransferTime  +  "  msec",  null, 
JOptionPane.INPORMATION_MESSAGE,  null ); 

resetApplicationO ; 

}  else{ 

outObjectToServer.writeBoolean(  false ); 
outObjectToServer.flushO; 

System.out.println(  "Pile:  "  +  fileNameToAsk  + 
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"  transfer  interrupted!" ); 

}  //end  if  else 

}  else  if(  fileHash.equals(  new  String(  "fileNotMatch" ) ) ){ 

System.out.println(  "Server  doesn't  have  the  file  version  asked!" ); 

}  //end  if  else 

try{ 

System.out.println(  "Close  socket" ); 
clientSocket.closeO; 

}  catch(  lOException  ioe  )  { 

}  //end  try  catch  block 
}  catch(  Exception  ce  ){ 

connectionStatus  =  TRYING_TO_CONNECT; 
transferStatusPanel.updateEileTransferStatusO; 

if(  connectionCounter  ==  (  MAX_RECONNECTION_TRIES 

MAX_TOTAE_TRIES  +  1  ) ){ 

JOptionPane.showMessageDialog(  null, 

"The  server  couldn't  be  reached  ",  null, 
JOptionPane.ERROR_MESSAGE,  null ); 

}  //end  if 

}  //end  try  catch  block 

if(  connectionStatus  ==  TRYING_TO_CONNECT  ){ 

System.out.println(  "Connection  failed!" ); 

}  //end  if 

firstiteration  =  false; 

}  //end  while  loop 

if(  !fileTransfered  &&  !cancelPileTransfer ){ 
fileRequest.setOffset(  offset ); 

System.out.println(  "fileHash  saved"  +  fileHash  ); 
fileRequest.setHash(  fileHash ); 
savePartialPileRequest(  fileRequest, 
fileInBytes  ); 

JOptionPane.showMessageDialog(  null,  "  Pile  transfer  failed!\n  "  + 

"The  partial  file  data  stored  for  future  use",  null, 
JOptionPane.INPORMATION_MESSAGE,  null ); 
resetApplicationO ; 

}  //end  if 

}  //end  askPorPileO  method 

*  Cancels  the  file's  transfer 
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*1 

public  void  cancelFileTransfer()  { 
cancelFileTransfer  =  true; 

}  //end  setFileNameToAskO  method 

*  Sets  the  file  name  to  ask  the  server 

* 

*  @param  fileName  the  string  file  name 
*1 

public  void  setFileNameToAsk(  String  fileName  ){ 
fileNameToAsk  =  fileName; 

}  //end  SetFileNameToAskO  method 

*  Starts  the  file  dowmnloading 

* 

*  @param  ask  true  if  the  ask  the  file  button  is  pressed 
*1 

public  void  setAskTheFile(  boolean  ask )  { 
askTheFile  =  ask; 

}  //end  SetFileNameToAskO  method 

/** 

*  Sets  the  server  mode  of  the  file  transfer 

* 

*  @param  mode  the  string  server  mode 
*1 

public  void  setServerMode(  String  mode  )  { 
serverMode  =  mode; 

}  //end  setServerModeO  method 

*  Sets  the  packet  size  for  the  file  transfer 

* 

*  @param  sizeOfThePacket  the  packet  size  selected  for  the  file  transfer 
*t 

public  void  setPacketSize(  int  sizeOfThePacket )  { 
packetSize  =  sizeOfThePacket; 

}  //end  setPacketSizeO  method 

*  Sets  the  offset  for  the  file  transfer 

* 

*  @param  theOffset  the  offset  value 
*1 
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public  void  setOffset(  int  theOffset )  { 
offset  =  theOffset; 

}  //end  setPacketSizeO  method 

*  Returns  the  name  of  the  file  asked  from  the  server 

* 

*  ©return  the  name  of  the  file  asked  from  the  server 
*/ 

public  synchronized  String  getServerSelected()  { 
notify  0; 

return  serverSelected; 

}  //end  getFileNameToAskO  method 

*  Returns  the  name  of  the  file  asked  from  the  server 

* 

*  ©return  the  name  of  the  file  asked  from  the  server 
*1 

public  synchronized  String  getFileNameToAsk(){ 
notify/); 

return  fileNameToAsk; 

}  //end  getFileNameToAskO  method 

*  Returns  the  size  of  the  file  asked  from  the  server 

* 

*  ©return  the  size  of  the  file  asked  from  the  server 
*/ 

public  synchronized  int  getPacketSize/)  { 
notify/); 

return  packetSize; 

}  //end  getPacketSize/)  method 

/** 

*  Returns  the  size  in  bytes  of  the  file  asked 

* 

*  ©return  the  size  ij  bytes  of  the  file  asked 
*1 

public  synchronized  int  getFileSize/)  { 
notify/); 
return  fileSize; 

}  //end  getFileSize/)  method 

*  Returns  the  number  of  packet  needed  for  the  transfer 
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* 

*  ©return  the  number  of  packets  need  for  the  transfer 
*1 

public  synchronized  int  getNumOfPackets(){ 
notify  0; 

return  numOfPackets; 

}  //end  getNumOfPacketsO  method 

*  Returns  the  number  of  packet  already  received 

* 

*  ©return  the  number  of  packet  already  received 
*/ 

public  synchronized  int  getReceivedPackets(){ 
notify  0; 

return  packetCounter; 

}  //end  getReceivedPacketsO  method 

*  Returns  the  file  bytes  as  byte  array 

* 

*  ©return  the  file  bytes  as  byte  array 
*/ 

public  synchronized  byte []  getFileInBytes(){ 
notify/); 

return  fileInBytes; 

}  //end  getFileInBytesO  method 

*  Returns  the  connection  status 

* 

*  ©return  the  connection  status 
*1 

public  synchronized  String  getConnectionStatus(){ 
notify/); 

return  connectionStatus; 

}  //end  getConnectionStatus/)  method 

*  Returns  the  connection  loss  times 

* 

*  ©return  the  connection  loss  times 
*/ 

public  synchronized  int  getConnectionLossTimes/){ 
notify/); 

return  connectionLossTimes; 
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}  //end  getConnectionLossTimesO  method 

*  Returns  the  total  file  transfer  time 

* 

*  ©return  the  total  file  transfer  time 
*1 

public  synchronized  long  getTotalFileTransferTime()  { 
notify  0; 

return  totalFileTransferTime; 

}  //end  getTotalFileTransferTimeO  method 

*  Returns  the  total  file  transfer  time 

* 

*  ©return  the  total  file  transfer  time 
*t 

public  synchronized  boolean  getFileTransfered()  { 
notify  0; 

return  fileTransfered; 

}  //end  getTotalFileTransferTimeO  method 

/** 

*  Returns  the  total  file  transfer  time 

* 

*  ©return  the  total  file  transfer  time 
*/ 

public  synchronized  ControlPanel  getControlPanel()  { 
notify/); 

return  controlPanel; 

}  //end  getTotalFileTransferTimeO  method 

*  Return  a  titled  JtextPanel  with  specific  attributes 

* 

*  ©param  titleText  the  delay  time  in  milliseconds 

*  ©param  charSize  the  character  size 

*  ©param  charColor  the  character  color 

*  ©param  backgroundColor  the  backgroundColor 

*  ©param  isUnderlined  if  the  character  is  underlined  or  not 

*  ©param  isBold  if  the  character  is  bold  or  not 

*  ©return  a  titled  JtextPanel  with  specific  attributes 
*1 

public  JTextPane  getTitledPanel/  String  titleText,  int  charSize, 
Color  charColor,  Color  backgroundColor, 
boolean  isUnderlined,  boolean  isBold )  { 
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JTextPane  textPane; 

Defaults tyledDocument  doc  =  new  DefaultStyledDocument(); 
textPane  =  new  JTextPane(  doc  ); 

Mutable AttributeSet  attr  =  new  SimpleAttributeSet(); 

//StyleConstants .  setB  ackground(attr,  Color  .blue) ; 
StyleConstants.setFontSize(  attr,  charSize ); 

StyleConstants. setUnderline(  attr,  isUnderlined  ); 
StyleConstants.setForeground(  attr,  charColor ); 

StyleConstants. setBold(  attr,  isBold ); 

textPane.setAlignmentX(  JTextPane. CENTER_ALIGNMENT ); 
textPane.setAlignmentY(  JTextPane. CENTER_AEIGNMENT ); 
textPane. setEditable(  false ); 
textPane. setEnabled(  false ); 

textPane. setBackground(  BACKGROUND_COEOR ); 
textPane. setCharacterAttributes(  attr,  true  ); 
textPane. setText(  titleText ); 
return  textPane; 

}  //end  getTitledPanelO  method 

*  Returns  the  boolean  value  of  file  transfering  status 

* 

*  ©return  true  if  file  is  still  transferring,  false  otherwise 
*1 

public  boolean  getPilelsTransferingO  { 
return  filelsTransfering; 

} 

*  Saves  a  partial  file  request  to  file  request  database  for  future  use 

* 

*  @param  partialEileRequest  the  partial  file  request  to  save  in  database 

*  @param  partialEileBytes  the  partial  file  bytes  to  save  in  database 
*1 

public  void  savePartialPileRequest(  PETPEileRequest  partialEileRequest, 
byte[]  partialEileBytes  ){ 

oldPartialTransferRequests.put(  partialEileRequest.  getEile(), 
partialEileRequest ); 

oldPartialTransfersBytes.put(  partialEileRequest.getEile(), 
partialEileBytes ); 

oldPartialTransfersEiles.add(  partialEileRequest.getEile() ); 

}  //end  savePartialEileRequestO  method 
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*  Deletes  a  partial  file  request  from  file  request  database 

* 

*  @param  partialFileNameRequested  the  name  of  the  file  of  the 

*  request  to  delete  from  database 
*1 

public  void  deletePartialFileRequest(  String  partialFileNameRequested ){ 

oldPartialTransferRequests.remove(  partialFileNameRequested ); 
oldPartialTransfersBytes.remove(  partialFileNameRequested ); 
oldPartialTransfersFiles.remove(  partialFileNameRequested ); 

}  //end  deletePartialFileRequestO  method 

/** 

*  Resets  the  client  application 
*1 

public  void  resetApplication()  { 

fileSize  =  0; 
fileHash  = 

connectionStatus  =  DISCONNECTED; 
connectionEossTimes  =  0; 
totalEileTransferTime  =  0; 

controlPanel.resetO ; 

transferProgressPanel.resetO ; 

transfers  tatusPanel.resetO ; 

imageProgressPanel.resetO ; 

}  //end  resetApplicationO  method 

/** 

*  Stops  the  panel  threads  of  the  downloading  panels 
*1 

public  void  startCheckToAsk(){ 
while(  true )  { 
delay/  50 ); 
if(  askTheEile )  { 
try{ 

askEorEile/  fileRequest ); 

}  catch/  Exception  e  )  { 

} 
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askTheFile  =  false; 

} 

} 

}  //end 

*  Delay  the  execution  of  the  code 

* 

*  @param  msec  the  delay  time  in  milliseconds 
*1 

public  void  delay(  int  msec  )  { 
try{ 

Thread,  sleep/  msec  ); 

}  catch/  InterruptedException  ie  )  { 

} 

}  //end  delay/)  method 

/** 

*  The  main  method 

* 

*  @param  args  the  arguments 

*  ©throws  Exception  if  exception  occurs  in  ETPClient  application 
*/ 

public  static  void  main/  String  args[]  )  throws  Exception/ 

PETPClient  client  =  new  PETPClient/); 
client.startCheckToAsk/); 

}  //end  main  method 


// 

// 

//  Private  Inner  Classes: 

// 

// 

*  Provide  a  control  panel  to  control  the  application 
*1 

private  class  ControlPanel  extends  JPanel{ 

/**  The  PETPClient  class  object  */ 
private  PETPClient  controlPanelClient; 

/**  The  panel  that  shows  the  transfer  progress  */ 
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private  TransferProgressPanel  progressPanel; 

/**  The  panel  that  shows  the  transfer  status  during  downloading  */ 
private  TransferStatusPanel  statusPanel; 

/**  The  panel  that  displays  the  image  during  the  downloading  */ 
private  ImageProgressPanel  imagePanel; 

/**  The  title  for  the  control  panel  */ 
private  JPanel  controlPanelTitle; 

/**  The  FileSelectionDialog  object  for  file  choice  */ 
private  FileSelectionDialog  fileChoiceDialog; 

/**  The  text  field  for  file  choice  */ 
private  JTextField  fileChoiceField; 

/**  The  combo  box  for  server  mode  choice  */ 
private  JComboBox  serverModeChoiceBox; 

/**  The  combo  box  for  packet  size  choice  */ 
private  JComboBox  packetSizeChoiceBox; 

/**  The  button  group  for  file  choice  */ 
private  ButtonGroup  fileButtonGroup; 

/**  The  button  group  for  server  choice  */ 
private  ButtonGroup  serverButtonGroup; 

*  The  radio  button  that  give  the  option  to  retrieve 

*  previous  partial  transferred  files 
*/ 

private  JRadioButton  previousFailedFiles; 

*  The  radio  button  that  give  the  option  to  retrieve 

*  files  from  a  PFTP  server 
*1 

private  JRadioButton  filesFromServer; 

*  The  radio  button  that  give  the  option  to  the  user 

*  to  enter  the  server  IP  manually 
*1 

private  JRadioButton  manualServerSelection; 
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*  The  radio  button  that  give  the  option  to  the  user 

*  to  from  the  predefined  PFTP  servers 
*1 

private  JRadioButton  predefinedServerSelection; 

/**  The  button  to  a  server  manual  */ 
private  JButton  selectServer; 

/**  The  button  to  retreive  the  availiable  file  at  PFTP  Server  */ 
private  JButton  retreive AvailableFiles; 

/**  The  button  to  ask  for  the  file  transfer  */ 
private  JButton  askTheFile; 

/**  The  button  to  cancel  the  file  transfer  */ 
private  JButton  cancelTransfer; 

/**  The  text  field  to  enter  manual  the  server  to  ask  the  file  from  */ 
private  JTextField  manualSelectServer; 

/**  The  server  IP  array  with  servers  can  be  chosen  */ 
private  String[]  serverlPs; 

/**  The  packet  size  array  with  the  packet  sizes  can  be  chosen  */ 
private  String[]  packets izes; 

/**  The  file  selected  */ 
private  String  fileSelection; 

/**  The  server  selected  */ 
private  String  serverSelection; 

/**  The  packet  size  selected  */ 
private  String  packetSizeSelection; 

/**  The  boolean  value  if  a  file  selected  or  not  */ 
private  boolean  fileSelected  =  false; 

/**  The  boolean  value  if  a  server  selected  or  not  */ 
private  boolean  serverSelected  =  false; 

/**  The  boolean  value  if  a  packet  size  selected  or  not  */ 
private  boolean  packetSizeSelected  =  false; 
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*  The  default  constructor 

* 

*  @param  panelClient  the  FTPClientVer?  object  assosiated  with 

*  @param  progressPanel  the  TransferProgressPanel  object  assosiated  with 

*  @param  statusPanel  the  TransferStatusPanel  object  assosiated  with 

*  @param  imagePanel  the  ImageProgressPanel  object  assosiated  with 
*/ 

public  ControlPanel(  PFTPClient  panelClient, 

TransferProgressPanel  progressPanel, 

TransferStatusPanel  statusPanel, 

ImageProgressPanel  imagePanel ){ 


superO; 

serverlPs  =  new  String[VALID_SERVERS.length  +  2]; 
for(  int  i  =  0;  i  <  serverlPs. length;  i++  ){ 
if(i==0){ 

serverIPs[i]  =  "Select  server"; 

}  else  if(  i  ==  1 )  { 

serverIPs[i]  =  "Auto  select"; 

}  else{ 

serverIPs[i]  =  VAEID_SERVERS[i  -  2]; 

}  //end  if  else  if 
}  //end  for  loop 

packets izes  =  new  String[PACKET_SIZES. length  +1]; 
for(  int  i  =  0;  i  <  packets  izes. length;  i++  ){ 
if(i==0){ 

packets  izes  [i]  =  "Select  packet  size"; 

}  else{ 

packetSizes[i]  =  PACKET_SIZES[i  -  1]; 

}  //end  if  else  if 
}  //end  for  loop 

controlPanelClient  =  panelClient; 
progressPanel  =  progressPanel; 
statusPanel  =  statusPanel; 
imagePanel  =  imagePanel; 

setBorder(  BorderPactory.createEineBorder(  PANEE_BORDER_COEOR  ) ); 
setBackgroundC  BACKGROUND_COEOR ); 
setEayout(  new  GridEayout(  8,  3  ) ); 

add(  getTitledPanel(  "CONTROE  PANEE",  PANEE_TITEE_EONT_SIZE, 
EONT_COEOR, 
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BACKGROUND_COLOR,  true,  true  ) ); 

//  just  to  fill  the  empty  cells 
controlPanelClient.addPanel(  this  ); 
controlPanelClient.addPanel(  this ); 

//  construct  textfield  with  default  sizing 

add(  getTitledPanel(  "File  to  retreive:",  PANEL_LABEL_FONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
fileButtonGroup  =  new  ButtonGroupO; 

previousEailedEiles  =  new  JRadioButton(  "Previous  failures",  false  ); 
filesEromServer  =  new  JRadioButton(  "PETP  Server  files",  true  ); 

//inner  class  to  handle  JRadioButton  events 
ItemEistener  fileMode  =  new  ItemListener()  { 

//  handle  JRadioButton  event 

public  void  itemStateChanged(  ItemEvent  event ){ 

//  determine  whether  check  box  selected 
if(  event.getSourceO  ==  previousEailedEiles  ){ 

String[]  filcEist  =  new  String[oldPartialTransfersEiles.size()  +  1]; 
for(  int  i  =  0;  i  <  fileEist.length;  i++  ){ 
if(i==0){ 

fileEist[i]  =  "Select  file"; 

}  else{ 

fileEist[i]  =  (  String  )  oldPartialTransfersEiles.get(  i  -  1  ); 

}  //end  if  else 
}  //end  for  loop 

if(  previousEailedEiles. isSelectedO  && 
loldPartialTransfersEiles.isEmptyO  ) { 
retrieveEailedTransfers  =  true; 

fileChoiceDialog  =  new  EileSelectionDialog(  controlPanelClient, 
controlPanelClient.getControlPanelO, 
fileChoiceEield, 
fileEist ); 

packets  izeSelected  =  true; 

}  else  if(  previousEailedEiles. isSelectedO  && 
oldPartialTransfersEiles.isEmptyO  )  { 
JOptionPane.showMessageDialog(  null, 

"No  file  transfer  failure  by  now!\n"  + 

"Select  a  file  from  the  PETP  servers.", 
null, 

JOptionPane.INPORMATION_MESSAGE, 
null ); 
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manualServerSelection.setEnabled(  false ); 
predefinedServerSelection.setEnabled(  false ); 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceBox.setEnabled(  false ); 
retreiveAvailableEiles.setEnabled(  false ); 
packets izeChoiceBox.setEnabled(  false ); 
askTheEile.setEnabled(  false ); 

} 

}  else  if(  event.getSourceO  ==  filesEromServer ){ 
manualServerSelection.setEnabled(  true ); 
predefinedServerSelection.setEnabled(  true ); 
serverModeChoiceBox.setEnabled(  true ); 
askTheEile.setEnabled(  true ); 

}  //end  if  else 
}  //end  itemstateChanged 

} ;  //  end  anonymous  inner  class 

previousEailedEiles.addItemEistener(  fileMode ); 
previousEailedEiles.setBackground(  BACKGROUND_COEOR ); 
previousEailedEiles.setEoreground(  EONT_COEOR ); 

filesEromServer.  addItemEistener(  fileMode ); 
filesEromServer. setBackground(  BACKGROUND_COEOR ); 
filesEromServer.setEoreground(  EONT_COEOR ); 

fileButtonGroup.add(  previousEailedEiles ); 
fileButtonGroup.add(  filesEromServer ); 

add(  previousEailedEiles  ); 
add(  filesEromServer ); 

//  construct  textfield  with  default  sizing 

add(  getTitledPanel(  "Server  to  receive  from:",  PANEE_EABEE_EONT_SIZE, 
PONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
serverButtonGroup  =  new  ButtonGroupO; 

manualServerSelection  =  new  JRadioButton(  "Manual  Selection",  false  ); 
predefinedServerSelection  =  new  JRadioButton(  "Existing  Servers",  true  ); 

//inner  class  to  handle  JRadioButton  events 
ItemEistener  serverEistener  =  new  ItemEistener()  { 

//  handle  JRadioButton  event 
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public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  a  radio  button  selected 
if(  event.getSourceO  ==  manualServerSelection  ){ 
manualSelectServer.setEnabled(  true ); 
serverModeChoiceBox.setEnabled(  false ); 
selectServer.setEnabled(  true ); 

}  else  if(  event.getSourceO  ==  predefinedServerSelection  ){ 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceBox.setEnabled(  true ); 

}  //end  if  else 
}  //end  itemstateChanged 

} ;  //  end  anonymous  inner  class 

manualServerSelection. addItemEistener(  serverEistener ); 
manualServerSelection. setBackground(  BACKGROUND_COEOR ); 
manualServerSelection. setEoreground(  EONT_COEOR ); 

predefinedServerSelection. addItemEistener(  serverEistener ); 
predefinedServerSelection. setBackground(  BACKGROUND_COEOR ); 
predefinedServerSelection. setEoreground(  EONT_COEOR ); 

serverButtonGroup.add(  manualServerSelection ); 
serverButtonGroup.add(  predefinedServerSelection ); 

add(  manualServerSelection ); 
add(  predefinedServerSelection ); 

//  construct  textfield  with  default  sizing 

add(  getTitledPanel(  "Add  Server  IP:",  PANEE_EABEE_PONT_SIZE, 
PONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 

manualSelectServer  =  new  JTextPield(  "Enter  server  IP" ); 
manualSelectServer.setEditable(  true ); 
manualSelectServer.  setEnabled(  false ); 
add(  manualSelectServer ); 

//  constructs  the  select  server  button 
selectServer  =  new  JButton(  "Select  the  server" ); 

selectServer.setPont(  new  Pont(  null,  Eont.BOED,  PANEE_EABEE_PONT_SIZE  ) ); 
selectServer. setPoreground(  PONT_COEOR ); 
selectServer.setHorizontalTextPosition(  JButton.EEET ); 
selectServer.setBackground(  BACKGROUND_COEOR ); 
selectServer.setEnabled(  false ); 
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selectServer.addActionListener(  new  ActionListener()  { 
public  void  actionPerfomied(  ActionEvent  event )  { 

try{ 

String  serverIP  =  manualSelectServer.getText(); 

InetAddress.getByName(  serverIP ); 
if(  IretrieveFailedTransfers  ){ 
retreiveAvailableFiles.setEnabled(  true ); 

} 

packets izeChoiceBox.setEnabled(  false ); 
controlPanelClient.setServerMode(  serverIP ); 
serverSelected  =  true; 

}  catch(  UnknowuHostException  uhe  ){ 

J OptionPane .  showMess ageDialog(  null, 

"Select  a  valid  server  IP  address!", 
null, 

JOptionPane.INFORMATION_MESSAGE, 
null ); 

} 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

add(  selectServer ); 

//  construct  textfield  with  default  sizing 

add(  getTitledPanel(  "Choose  server  mode:",  PANEE_EABEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 

//  construct  textfield  with  default  sizing 
serverModeChoiceBox  =  new  JComboBox(  serverlPs ); 
serverModeChoiceBox.setFont(  new  Font(  null,  Font.BOED, 

PANEE_EABEE_FONT_SIZE ) ); 
serverModeChoiceBox. setBackground(  BACKGROUND_COEOR ); 
serverModeChoiceBox.  setForeground(  FONT_COEOR ); 
serverModeChoiceBox.  setEnabled(  true ); 
serverModeChoiceBox.addItemEistener( 

//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemEistener(){ 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
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if(  event.getStateChangeO  ==  ItemEvent.SELECTED  ){ 
serverSelection  =  serverIPs[serverModeChoiceBox.getSelectedIndex()] ; 
serverSelected  =  true; 
if(  IretrieveEailedTransfers  ){ 
retreiveAvailableEiles.setEnabled(  true ); 

} 

} 

controlPanelClient.setServerMode(  serverSelection ); 

} 

}  //  end  anonymous  inner  class 

);  //  end  call  to  addItemEistener 
add(  serverModeChoiceBox ); 

//  constructs  the  retreive  files  button 
retreivcAvailableEiles  =  new  JButton(  "Retreive  files..  " ); 
retreiveAvailableEiles.setEont(  new  Eont(  null,  Eont.BOED, 

PANEE_EABEE_EONT_SIZE ) ); 
retreivcAvailableEiles. setEoreground(  EONT_COEOR ); 
retreiveAvailableEiles.setHorizontalTextPosition(  JButton.EEET ); 
retreiveAvailableEiles.setBackground(  BACKGROUND_COEOR ); 
retreive  A  vailableEiles.addActionEistener(  new  ActionEistener(){ 
public  void  actionPerformed(  ActionEvent  event )  { 
try{ 

serverAvailableEiles  =  controlPanelClient.getServerAvailableEiles() ; 
retreiveAvailableEiles.setEnabled(  false ); 
if(  !serverAvailableEiles.isEmpty() ){ 

String[]  fileEist  =  new  String[serverAvailableEiles.size()  +  1]; 
for(  int  i  =  0;  i  <  fileEist.length;  i++  ){ 
if(i==0){ 

fileEist[i]  =  "Select  file"; 

}  else{ 

fileEist[i]  =  (  String  )  serverAvailableEiles. get(  i  -  1  ); 

}  //end  if  else 
}  //end  for  loop 

fileChoiceDialog  =  new  EileSelectionDialog(  controlPanelClient, 
controlPanelClient.getControlPanelO, 
fileChoiceEield, 
fileEist ); 

packets izeChoiceBox.setEnabled(  true ); 

}  else{ 

J OptionPane.  showMessageDialog(  null, 

"No  files  availiable  at  server", 
null, 

JOptionPane.INPORMATION_MESSAGE, 
null ); 
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}  //end  if  else 

}  catch(  lOException  ioe  )  { 

J OptionPane .  showMess ageDialog(  null, 

"Fail  to  retreive  file  names  from  PFTP  server", 

"Exception", 

JOptionPane.ERROR_MESSAGE,  null ); 
retreiveAvailableFiles.setEnabled(  false ); 

}  catch(  ClassNotFoundException  cnfe  )  { 

JOptionPane.showMessageDialog(  null,  "Unknown  object  received", 

"Exception", 

JOptionPane.ERROR_MESSAGE,  null ); 
retreiveAvailableFiles.setEnabled(  false ); 

}  //end  try  catch  block 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

retreiveAvailableFiles.setEnabled(  false ); 
add(  retreivcAvailableFiles  ); 

//  construct  textfield  with  default  sizing 

add(  getTitledPanel(  "File  selected  PANEE_EABEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 

//  construct  textfield  with  default  sizing 
fileChoiceField  =  new  JTextField(  "No  file  selected" ); 

fileChoiceField.setFont(  new  Font(  null,  Font.BOED,  PANEE_EABEE_FONT_SIZE 

fileChoiceField.setBackground(  BACKGROUND_COEOR ); 
fileChoiceField.setForeground(  FONT_COEOR ); 
fileChoiceField.  setEditable(  false ); 

add(  fileChoiceField ); 

//  construct  packet  size  choice  box 

packets izeChoiceBox  =  new  JComboBox(  packets izes  ); 

packets izeChoiceBox.setFont(  new  Font(  null,  Font.BOED, 

PANEF_FABEF_FONT_SIZE ) ); 
packets  izeChoiceBox.  setBackground(  BACKGROUND_COFOR  ); 
packetSizeChoiceBox.setForeground(  FONT_COFOR ); 
packets izeChoiceBox.setEnabled(  true ); 
packets  izeChoiceBox. addItemFistener( 
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//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemListenerO  { 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event.getStateChangeO  ==  ItemEvent.SELECTED  ){ 
packets  izeSelection  =  packets  izes  [packets  izeChoiceBox. 
getSelectedIndexO] ; 

System.out.println(  "packet  size  selected..  "  +  packets  izeSelection  ); 
controlPanelClient.setPacketSize(  new  Integer(  packets  izeSelection  ). 
intValueO  ); 

packets  izeSelected  =  true; 
askThePile.setEnabled(  true ); 

} 


} 

}  //  end  anonymous  inner  class 

);  //  end  call  to  addItemEistener 

packets izeChoiceBox.setEnabled(  false ); 
add(  packets  izeChoiceBox ); 

controlPanelClient.addPanel(  this ); 

//  constructs  the  download  button 
askTheEile  =  new  JButton(  "Download  ", 

new  ImageIcon(  "downloadArrow.gif" ) ); 

askTheEile. setEont(  new  Eont(  null,  Eont.BOED,  PANEE_EABEE_EONT_SIZE  ) ); 
askTheEile. setEoreground(  EONT_COEOR ); 
askTheEile. setHorizontalTextPosition(  JButton.EEET ); 
askTheEile.setBackgroundC  BACKGROUND_COEOR ); 
askTheEile. addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
if(  fileSelected  &&  serverSelected  &&  packetSizeSelected )  { 

//  change  enabled  status  of  panel  elements 
filesEromServer.setEnabled(  false ); 
previousEailedEiles.setEnabled(  false ); 
manualServerSelection.setEnabled(  false ); 
predefinedServerSelection.setEnabled(  false ); 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceBox.setEnabled(  false ); 
retreiveAvailableEiles.setEnabled(  false ); 
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packets izeChoiceBox.setEnabled(  false ); 
askTheFile.setEnabled(  false ); 
cancelTransfer.setEnabled(  true ); 

//  create  a  file  request  object 
controlPanelClient.setOffset(  0 ); 
fileSelection  =  fileChoiceEield.getText(); 
if(  IretrieveEailedTransfers  ){ 

fileRequest  =  new  PETPEileRequest(  FIEE_REQUEST_TYPE, 
fileSelection, 
new  String( "" ),  0, 
new  Integer( 
packets izeSelection ). 

intValueO  ); 

}  else{ 

fileRequest  =  (  PFTPFileRequest ) 

oldPartialTransferRequests.get(  fileSelection ); 

}  //end  if  else 

try{ 

controlPanelClient.setAskTheFile(  true ); 

}  catch(  Exception  e  )  { 

JOptionPane.showMessageDialog(  null,  "Problem  in  asking  the  file"  + 
fileNameToAsk,  "Exception", 
JOptionPane.ERROR_MESSAGE ); 

}  //end  try  catch  block 

}  else  if(  !fileSelected  ){ 
if(  serverSelected  &&  packetSizeSelected )  { 
JOptionPane.showMessageDialog(  null, 

"Please  select  server,  file  and  packet  size  first!" ); 

}  else  if(  !  serverSelected  &&  IpacketSizeSelected ){ 
JOptionPane.showMessageDialog(  null, 

"Please  select  server,  file  and  packet  size  first!" ); 

}  else  if(  !  serverSelected  ){ 

JOptionPane.showMessageDialog(  null, 

"Please  select  the  server  and  a  file  first!" ); 

}  else  if(  !packetSizeSelected  ){ 

J OptionPane . showMess ageDialog(  null, 

"Please  select  a  file  and  a  packet  size  first!" ); 

}  //end  if  else  if 

}  else  if(  serverSelected  &&  !packetSizeSelected  ){ 

J  OptionPane .  showMess  ageDialog(  null, 

"Please  select  packet  size  first!" ); 

}  else  if(  !  serverSelected  &&  packetSizeSelected  ){ 
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J OptionPane .  showMess ageDialog(  null, 

"Please  select  server  first!" ); 

}  else  if(  IserverSelected  &&  IpacketSizeSelected  ){ 

J  OptionPane .  showMess  ageDialog(  null, 

"Please  select  the  server  and  packet  size  first!" ); 

}  //end  if  else  if 

}  //end  actionPerformedO  method 
}  //end  ActionListener  class 
);  //end  addActionListener()  method 
askTheFile.setEnabled(  false ); 

add(  askTheFile ); 

//  constructs  the  stop  transfer  button 
cancelTransfer  =  new  JButton(  "Cancel  Download" ); 

cancelTransfer.setFont(  new  Font(  null,  Font.BOFD,  PANEF_FABEF_FONT_SIZE 

cancelTransfer.setForeground(  FONT_COEOR ); 
cancelTransfer.setHorizontalTextPosition(  JButton.EEFT ); 
cancelTransfer.setBackground(  BACKGROUND_COEOR ); 
cancelTransfer.setEnabled(  false ); 

cancelTransfer.  addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
int  option  =  JOptionPane.showOptionDialog(  null, 

"Are  you  sure  you  want  to  cancel "  + 

"  download?",  "Warning",  JOptionPane.YES_NO_OPTION, 
JOptionPane.QUESTION_MESSAGE,  null,  null 
,  null ); 

if(  option  ==  JOptionPane.OK_OPTION  ){ 
controlPanelClient.cancelFileTransferO; 
resetApplicationO ; 

}  //end  if 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

add(  cancelTransfer ); 

controlPanelClient.addPanel(  this ); 
controlPanelClient.addPanel(  this ); 


setVisible(  true ); 


}  //end  constructor 

*  Sets  the  fileSelected  value 

* 

*  @param  state  the  the  fileSelected  boolean  value 
*1 

public  void  setFileSelected(  boolean  state  )  { 
fileSelected  =  state; 

}  //end  setFileSelectedO  method 

*  Resets  the  panel 
*1 

public  void  reset()  { 

//reset  all  the  panel  components 
filesFromServer.setEnabled(  true ); 
filesFromServer.setSelected(  true ); 
previousFailedFiles.setEnabled(  true ); 
manualServerSelection.setEnabled(  true ); 
predefinedServerSelection.setEnabled(  true ); 
predefinedServerSelection.setSelected(  true ); 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceBox.setEnabled(  true ); 
retreiveAvailableEiles.setEnabled(  false ); 
packets izeChoiceBox.setEnabled(  false ); 
askTheEile.setEnabled(  true ); 
cancelTransfer.setEnabled(  false ); 
fileSelected  =  false; 
serverSelected  =  false; 
packetSizeSelected  =  false; 
filelsTransfering  =  false; 

}  //end  reset()  method 
}  //end  ControlPanel  class 

/** 

*  Provide  a  transfer  progress  panel  to  monitor  the  progress  of  file  transfer 
*/ 

private  class  TransferProgressPanel  extends  JPanel{ 

/**  The  PETP  Client  of  the  transfer  progress  panel  */ 
private  PETPClient  transferProgressPanelClient; 
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/**  The  download  message  panel  */ 
private  JPanel  downloadMessagePanel; 

/**  The  download  message  */ 
private  JLabel  downloadMessage; 

/**  The  progress  bar  panel  */ 
private  JPanel  progressBarPanel; 

/**  The  progress  bar  */ 
private  JProgressBar  progressBar; 

/**  The  panel  with  the  download  percentage  panel  */ 
private  JPanel  downloadPercentagePanel; 

/**  The  file  downloading  message  */ 
private  JLabel  downloadPercentage; 

/**  The  file  downloading  message  */ 
private  String  fileToTransfer; 

*  The  default  constructor 

* 

*  @param  client  the  PFTPClient  object 
*1 

public  TransferProgressPanel(  PFTPClient  client )  { 
superO; 

transferProgressPanelClient  =  client; 

setBorder(  BorderFactory.createLineBorder(  PANEL_BORDER_COLOR  ) ); 
setBackground(  BACKGROUND_COEOR ); 
setEayout(  new  GridEayout(  5,  1 ) ); 

//  construct  textfield  with  default  sizing 

add(  getTitledPanel(  "TRANSEER  PROGRESS",  PANEE_TITEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  true,  true  ) ); 
transferProgressPanelClient.addPanel(  this ); 
downloadMessagePanel  =  new  JPanel(); 

downloadMessagePanel. setBackground(  BACKGROUND_COEOR ); 
downloadMessage  =  new  JEabel(  "No  file  is  downloading" ); 
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downloadMessage.setFont(  new  Font(  null, 

PANEL_LABEL_FONT_SIZE ) ); 

downloadMessage.setEoreground(  EONT_COEOR ); 
downloadMessagePanel.add(  downloadMessage ); 
add(  downloadMessagePanel ); 

progressBar  =  new  JProgressBar(); 
progressBar.setBackground(  new  Color(  207,  233,  245  ) ); 
//progressBar.setBorderPainted(tme); 
add(  progressBar ); 

downloadPercentagePanel  =  new  JPanel(); 

downloadPercentagePanel.setBackground(  BACKGROUND_COEOR ); 
downloadPercentage  =  new  JEabel(); 
downloadPercentage.setPont(  new  Pont(  null,  Eont.BOED, 

PANEE_EABEE_PONT_SIZE ) ); 
downloadPercentage. setPoreground(  PONT_COEOR ); 
downloadPercentagePanel. add(  downloadPercentage ); 
add(  downloadPercentagePanel ); 

setVisible(  true ); 

}  //  end  constructor 

*  Sets  the  progress  bar 

* 

*  @param  max  the  progress  bar  max 
*/ 

public  void  setProgressBarMax(  int  max  ){ 
progressBar. setMinimum(  0 ); 
progressBar.setMaximum(  max ); 

}  //end  setProgressBarMaxO  method 

*  Updates  the  progress  bar 

* 

*  @param  value  the  progress  bar  value 
*/ 

public  void  updateProgressBar(  int  value  ){ 

if(  transferProgressPanelClient.getPilelsTransferingO  )  { 
SwingUtilities.invokeEater(  new  UpdateEabel(  downloadMessage, 
"Downloading  file  "  + 

transferProgressPanelClient.getPileNameToAskO  ) ); 

}  else{ 


Eont.BOED, 
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SwingUtilities.invokeLater(  new  UpdateLabel(  downloadMessage, 
"No  file  is  downloding" ) ); 


} 

SwingUtilities.invokeLater(  new  UpdateProgressBar(  progressBar,  value  ) ); 
SwingUtilities.invokeLater(  new  UpdateLabel(  downloadPercentage, 
Math.floor(  ( (  double  )  value  / 

progressBar.getMaximumO  )  *  100  )  +  "  %" ) ); 

}  //end  updateProgressBarO  method 

*  Resets  the  transfer  progress  panel 
*/ 

public  void  reset()  { 

SwingUtilities.invokeLater(  new  UpdateLabel(  downloadMessage, 

"No  file  is  downloding" ) ); 

SwingUtilities.invokeLater(  new  UpdateProgressBar(  progressBar,  0  ) ); 
SwingUtilities.invokeLater(  new  UpdateLabel(  downloadPercentage, 

}  //end  resetO  method 

}  //end  TransferProgressPanel  class 

*  Provide  a  transfer  status  panel  to  monitor  the  file  transfer  status 
*/ 

private  class  Transfers tatusPanel  extends  JPanel{ 

/**  The  panel  that  shows  the  transfer  status  */ 
private  PFTPClient  transferStatusPanelClient; 

/**  The  transfer  status  panel  title  */ 
private  JTextPane  transferStatusPanelTitle; 

/**  The  file  asked  info  */ 
private  JTextPane  fileAskedInfo; 

/**  The  file  size  info  */ 
private  JTextPane  fileSizeInfo; 

/**  The  packet  size  used  info  */ 
private  JTextPane  packetSizeUsedInfo; 

/**  The  connection  status  info  */ 
private  JTextPane  connectionStatusInfo; 
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/**  The  connection  loss  number  info  */ 
private  JTextPane  connectionLossNumberInfo; 

/**  The  total  file  transfer  time  info  */ 
private  JTextPane  totalFileTransferTimeInfo; 

*  The  default  constructor 

* 

*  @param  client  the  PFTPClient  object 
*1 

public  TransferStatusPanel(  PFTPClient  client ){ 
superO; 

transferStatusPanelClient  =  client; 

setBorder(  BorderFactory.createLineBorder(  PANEL_BORDER_COLOR  ) ); 

fileAskedInfo  =  getTitledPanel(  "No  file  asked",  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
fileAskedInfo. setEoreground(  EONT_COEOR ); 

fileSizeInfo  =  getTitledPanel(  "",  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
fileSizeInfo. setEoreground(  EONT_COEOR ); 

packetSizeUsedInfo  =  getTitledPanel( "",  PANEE_EABEE_EONT_SIZE, 

EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
packetSizeUsedInfo. setEoreground(  EONT_COEOR ); 

connectionStatusInfo  =  getTitledPanel(  "Disconnected", 

PANEE_EABEE_EONT_SIZE,  EONT_COEOR, 
BACKGROUND_COEOR,  false,  true ); 
connectionStatusInfo. setEoreground(  EONT_COEOR ); 

connectionEossNumberInfo  =  getTitledPanel(  "0", 

PANEE_EABEE_EONT_SIZE, 

EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
connectionEossNumberInfo.setEoreground(  EONT_COEOR ); 

totalEileTransferTimeInfo  =  getTitledPanel(  "0  msec". 
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PANEL_LABEL_FONT_SIZE, 

EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
totalEileTransferTimeInfo.setEoreground(  EONT_COEOR ); 

setBackground(  BACKGROUND_COEOR ); 
setEayout(  new  GridEayout(  7,  2  ) ); 

add(  getTitledPanel(  "TRANSFER  STATUS",  PANEE_TITEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  true,  true  ) ); 

add(  getTitledPanel(  "",  PANEE_EABEE_FONT_SIZE,  FONT_COEOR, 
BACKGROUND_COEOR,  false,  true  ) ); 

add(  getTitledPanel(  "File  asked  PANEE_EABEE_FONT_SIZE,  FONT_COEOR, 
BACKGROUND_COEOR,  false,  true  ) ); 

add(  fileAskedInfo ); 

add(  getTitledPanel(  "File  size  :",  PANEE_EABEE_FONT_SIZE,  FONT_COEOR, 
BACKGROUND_COEOR,  false,  true  ) ); 

add(  fileSizeInfo ); 

add(  getTitledPanel(  "Packet  size  used  :",  PANEE_EABEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
add(  packets izeUsedInfo ); 

add(  getTitledPanel(  "Connection  status  PANEE_EABEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
add(  connectionStatusInfo ); 

add(  getTitledPanel(  "Connection  loss  number  PANEE_EABEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
add(  connectionEossNumberInfo ); 

add(  getTitledPanel(  "Total  transfer  time:",  PANEE_EABEE_FONT_SIZE, 
FONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
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add(  totalFileTransferTimeInfo ); 

setVisible(  true ); 
this.setEnabled(  false ); 

}  //end  constructor 

*  Updates  file  transfer's  status 
*f 

public  void  updateFileTransferStatus(){ 

SwingUtilities.invokeLater(  new  UpdateTextPane(  fileAskedInfo, 
transferStatusPanelClient.getFileNamcToAskO  ) ); 

SwingUtilities.invokeFater(  new  UpdateTextPane(  fileSizeInfo, 
new  Integer( 

transfers tatusPanelClient.getFileSizeO  ).toString() ) ); 

SwingUtilities.invokeFater(  new  UpdateTextPane(  packets izeUsedInfo, 
new  Integer( 

transfers tatusPanelClient.getPacketSizeO  ).toString() ) ); 

String  connects tatus  =  transfers tatusPanelClient.getConnectionStatus(); 
if(  connectStatus.equals(  CONNECTED  ) ){ 

SwingUtilities.invokeEater(  new  UpdateTextPane(  connectionStatusInfo, 
connectStatus  +  "  with  "  + 
transfers tatusPanelClient.getServerSelectedO  ) ); 

}  else{ 

SwingUtilities.invokeEater(  new  UpdateTextPane(  connectionStatusInfo, 
connectStatus  ) ); 

} 

SwingUtilities.invokeEater(  new  UpdateTextPane(  connectionEossNumberInfo, 
new  Integer( 

transferStatusPanelClient.getConnectionEossTimesO  ).toString() ) ); 

SwingUtilities.invokeEater(  new  UpdateTextPane(  totalFileTransferTimeInfo, 
new  Eong( 

transferStatusPanelClient.getTotalFileTransferTimeO  ).toString()  + 

"  msec" ) ); 

}  //end  updateFileTransferStatusO  method 
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*  Resets  the  panel 
*1 

public  void  reset()  { 


SwingUtilities.invokeLater(  new  UpdateTextPane(  fileAskedInfo, 

"No  file  asked" ) ); 

SwingUtilities.invokeLater(  new  UpdateTextPane(  fileSizeInfo, 

SwingUtilities.invokeLater(  new  UpdateTextPane(  packets izeUsedInfo, 

SwingUtilities.invokeLater(  new  UpdateTextPane(  connectionStatusInfo, 
"Disconnected" ) ); 

SwingUtilities.invokeLater(  new  UpdateTextPane(  connectionLossNumberInfo, 
"0" ) ); 

SwingUtilities.invokeLater(  new  UpdateTextPane(  totalFileTransferTimeInfo, 
"0  sec" ) ); 

}  //end  reset()  method 


} 

*  Provide  a  image  progress  panel  to  view  the  partial  file  transferred 
*/ 

private  class  ImageProgressPanel  extends  JPanel{ 

/**  The  PFTPClient  object  assosiated  with  this  panel  */ 
private  PFTPClient  imageProgressPanelClient; 

/**  The  image  progress  label  */ 
private  JLabel  imageProgressLabel; 

/**  The  updated  times  */ 
private  int  updatedTimes; 

/**  The  fileNameToPreview  */ 
private  String  fileNameToPreview; 

*  Constructor 

* 

*  @param  client  the  PFTPClient  object  assosiated  with  this  panel 
*/ 
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public  ImageProgressPanel(  PFTPClient  client )  { 
superO; 

imageProgressPanelClient  =  client; 
updatedTimes  =  0; 
fileNameToPreview  =  null; 

setBorder(  BorderFactory.createLineBorder(  PANEL_BORDER_COLOR  ) ); 
setBackground(  BACKGROUND_COEOR ); 
setEayout(  new  BorderEayout(  2,  1 ) ); 

Icon  noPreview  =  new  ImageIcon(  EOGO_IMAGE  ); 
imageProgressEabel  =  new  JEabel(  noPreview  ); 
imageProgressEabel.setPoreground(  PONT_COEOR ); 

ImageProgressEabel. setHorizontalTextPosition(  JEabel.CENTER ); 
ImageProgressEabel. setVerticalTextPosition(  JEabel.BOTTOM ); 
add(  ImageProgressEabel ); 

setVisible(  true ); 

}  //end  constructor 

*  Updates  the  iamage  progress  panel 

* 

*  @param  fileBytes  the  file  byte  array  to  display 
*/ 

public  void  updateImageProgress(  byte[]  fileBytes ){ 
try{ 

byte[]  currentImageBytes  =  fileBytes; 
int  fileEength  =  currentImageBytes.length; 
byte[]  endOfEile  =  (  new  String( )  ).getBytes(); 
int  endOfEileEength  =  endOfEile.length; 

ByteArrayOutputStream  baos  =  new  ByteArrayOutputStream(); 
baos.write(  currentImageBytes,  0,  fileEength  ); 
baos.write(  endOfFile,  0,  endOfFileEength  ); 
currentImageBytes  =  baos.  toByte  Array  (); 
baos.closeO; 

SwingUtilities.invokeEater(  new  UpdateImageEabel(  ImageProgressEabel, 
"Preview  of  file  "  +  imageProgressPanelClient.getPileNameToAsk(), 
new  ImageIcon(  currentImageBytes ) ) ); 
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}  catch(  Exception  e  )  { 

System.out.println(  e ); 

} 

}  ///end  updatelmageProgressO  method 

*  Resets  the  panel 
*/ 

public  void  reset()  { 

SwingUtilities.invokeLater(  new  UpdateImageLabel(  imageProgressLabel, 

tt  tt 
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new  ImageIcon(  LOGO_IMAGE  ) ) ); 

}  //end  reset()  method 
}  //end  ImageProgressPanel 

*  Updates  a  label  given  dynamically 
*/ 

public  class  UpdateEabel  extends  Thread { 

/**  The  label  to  update  */ 
private  JEabel  label; 

/**  The  text  to  set  on  the  label  */ 
private  String  text; 

*  Constructor 

*  @param  1  the  label 

*  @param  t  the  text  to  set  on  the  label 
*/ 

public  UpdateEabel(  JEabel  1,  String  t ){ 
label  =  1; 
text  =  t; 

}  //end  constructor 

//  method  called  to  update  label 
public  void  run()  { 
label.setText(  text ); 

}  //end  run()  method 

}  //  end  class  UpdateEabel 
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*  Updates  a  image  label  given  dynamically 
*f 

public  class  UpdatelmageLabel  extends  Thread{ 

/**  The  label  to  uadate  */ 
private  JLabel  label; 

/**  The  text  to  set  on  the  label  */ 
private  String  text; 

/**  The  icon  to  set  on  the  label  */ 
private  Icon  icon; 

*  Constructor 

*  @param  1  the  label 

*  @param  t  the  text  to  set  on  the  label 

*  @param  i  the  icon  to  set  on  the  label 
*1 

public  UpdateImageLabel(  JLabel  1,  String  t,  Imagelcon  i )  { 
label  =  1; 
text  =  t; 
icon  =  i; 

}  //end  constructor 

//  method  called  to  update  label 
public  void  run()  { 
label. setText(  text ); 
label. setIcon(  icon ); 

}  //end  run()  method 

}  //  end  class  UpdatelmageLabel 

*  Updates  a  image  text  pane  given  dynamically 
*1 

public  class  UpdateTextPane  extends  Thread{ 

/**  The  text  pane  to  update  */ 
private  JTextPane  textPane; 

/**  The  text  to  set  on  the  text  pane  */ 
private  String  text; 

/** 

*  Constructor 
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*  @param  jtp  the  text  tp  update 

*  @param  t  the  text  to  set  on  the  text  pane 
*1 

public  UpdateTextPane(  JTextPane  jtp,  String  t ){ 
textPane  =  jtp; 
text  =  t; 

}  //end  constructor 

//  method  called  to  update  text  pane 
public  void  run()  { 
textPane. setText(  text ); 

}  //end  run()  method 

}  //  end  class  UpdateTextPane 

/** 

*  Updates  a  progess  bar 
*t 

public  class  UpdateProgressBar  extends  Thread { 

/**  The  progress  bar  to  update  */ 
private  JProgressBar  progressBar; 

/**  The  value  to  set  for  the  progress  bar  */ 
private  int  progressBarValue; 

*  Constructor 

*  @param  bar  the  progress  bar  to  update 

*  @param  value  the  value  to  set  for  te  progress  bar 
*1 

public  UpdateProgressBar(  JProgressBar  bar,  int  value  ){ 
progressBar  =  bar; 
progressBarValue  =  value; 

}  //end  constructor 

//  method  called  to  update  progress  bar 
public  void  run()  { 

progressBar.setValue(  progressBarValue ); 

}  //end  run()  method 

}  //  end  class  UpdateProgressBar 

/** 

*  Displays  a  dialog  with  a  file  list  to  choose  from 
*1 
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private  class  FileSelectionDialog  extends  JDialog{ 

/**  The  dialog  client  */ 
private  PFTPClient  dialogClient; 

/**  The  dialog  control  panel  */ 
private  ControlPanel  dialogControlPanel; 

/**  The  dialog  text  field  */ 
private  JTextField  dialogTextField; 

/**  The  item  list  */ 
private  String[]  ItemList; 

/**  The  dialog  combo  box  */ 
private  JComboBox  dialogComboBox; 

/**  The  dialog  button  */ 
private  JButton  dialogButton; 

/**  The  dialog  selection  */ 
private  String  dialogSelection; 

*  Constructor 

* 

*  @param  client  the  PFTPClientPPC  object  assosiated  with 

*  @param  panel  the  ControlPanel  object  assosiated  with 

*  @param  fileField  the  dialog  field  to  set 

*  @param  list  the  list  of  items  to  choose 
*1 

public  FileSelectionDialog(  PFTPClient  client, 

ControlPanel  panel, 

JTextField  fileField, 

String[]  list 

){ 

super(  client,  "Choose  a  file  to  transfer",  true  ); 

dialogClient  =  client; 
dialogControlPanel  =  panel; 
dialogTextField  =  fileField; 

ItemList  =  list; 
dialogSelection  =  null; 

setBackground(  BACKGROUND_COLOR ); 
setSize(  300,  180 ); 
this.setLocation(  392,  134 ); 
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Container  c  =  getContentPane(); 
c.setLayout(  new  GridLayout(  5,  3  ) ); 

//  just  to  fill  the  empty  cell 

for(  int  i  =  0;  i  <  4;  i++  )  { 
dialogClient.addPanel(  c  ); 

} 

//  construct  textfield  with  default  sizing 
dialogComboBox  =  new  JComboBox(  itemList ); 
dialogComboBox.setFont(  new  Font(  null,  Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
dialogComboBox.setBackground(  BACKGROUND_COEOR ); 
dialogComboBox. setEoreground(  EONT_COEOR ); 
dialogComboBox.  setEnabled(  true ); 
dialogComboBox. addItemEistener( 

//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemEistenerO  { 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event. gets tateChangeO  ==  ItemEvent.  SEEECTED  ){ 
dialogSelection  =  itemEist[dialogComboBox. 
getSelectedIndexO] ; 

} 


} 

}  //  end  anonymous  inner  class 

);  //  end  call  to  addItemEistener 

c.add(  dialogComboBox ); 

for(  int  i  =  0;  i  <  5;  i++  ){ 
dialogClient.addPanel(  c  ); 

} 

//  constructs  the  ok  button 
dialogButton  =  new  JButton(  "OK" ); 

dialogButton.setEont(  new  Eont(  null,  Eont.BOED,  PANEE_EABEE_EONT_SIZE  ) 

dialogButton.setEoreground(  EONT_COEOR ); 
dialogButton. setHorizontalTextPosition(  JButton.EEET ); 
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dialogButton.setBackground(  BACKGROUND_COLOR ); 
dialogButton.addActionListener(  new  ActionListener()  { 
public  void  actionPerfomied(  ActionEvent  event )  { 
if(  dialogSelection  ==  null )  { 
dialogControlPanel.setFileSelected(  false ); 

J OptionPane .  showMess ageDialog(  null, 

"No  file  selected!", 
null, 

JOptionPane.INFORMATION_MESSAGE, 
null ); 


}  else{ 

dialogTextField.setText(  dialogSelection ); 
dialogControlPanel.setFileSelected(  true ); 
setVisible(  false ); 

}  //end  if  else 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

c.add(  dialogButton ); 

for(  int  i  =  0;  i  <  4;  i++  )  { 
dialogClient.addPanel(  c  ); 

} 

show(); 

}  //end  constructor 
}  //end  FileSelectionDialog  class 
}  //end  PFTPClient  class 
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//packages  for  network  componets 
import  java.io.*; 
importjava.net.*; 

//packages  for  user  interface  components 
import  java.awt.*; 
import  java. awt. event.*; 
import  java.util.*; 

//package  for  security  components 
import  j  ava.  security .  * ; 

//package  for  charecter  encoding  components 
import  sun.misc.*; 

*  File  PFTPClientPPC.java 

* 

*  This  is  a  FTP  Client  for  the  Pocket  PC  version 

* 

*  This  client  also  ask  for  a  file  and  stays  in  a  loop  keep  asking 

*  until  it  gets  it  all.  In  the  first  request  it  receives  the 

*  hash  value  of  the  requested  file  so  when  the  connection  is 

*  lost  client  can  ask  an  other  server  the  same  file  with  out 

*  worrying  about  the  authenticity  of  it. 

* 

*  ©author  LT  Peri k1  is  Pantoleon 

*  ©version  1.0 
*/ 

class  PFTPClientPPC  extends  Frame  { 

// 

// 

//  Private  Data  Members: 

// 

// 

/**  The  default  port  where  the  FTP  client  is  asking  the  server  */ 
private  static  final  int  FTP_PORT  =  6789; 

/**  The  string  array  with  the  valid  servers  can  be  chosen  */ 
private  static  final  String[]  VALID_SERVERS  =  { 

"127.0.0.1",  "131.120.105.237",  "131.120.105.250",  "131.120.201.46"}; 

/**  The  packet  size  array  with  the  packet  sizes  can  be  chosen  */ 
private  String[]  PACKET_SIZES  =  {new  String}  "32" ), 
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new  String(  "64" ),  new  String(  "128" ), 
new  String(  "256" ),  new  String(  "512" ), 
new  String(  "1024" )}; 

/**  The  connected  status  */ 

private  static  final  String  CONNECTED  =  "Connected"; 

/**  The  disconnected  status  */ 

private  static  final  String  DISCONNECTED  =  "Disconnected"; 

/**  The  status  when  the  client  is  trying  to  connect  */ 

private  static  final  String  TRYING_TO_CONNECT  =  "Trying  to  connect . "; 

/**  The  timeout  period  of  the  TCP  sockets  */ 
private  static  final  int  SO_TIME_OUT  =  3000; 

/**  The  length  in  bytes  of  the  file  hash  value  */ 
private  static  final  int  MD5_HASH_EENGTH  =  16; 

/**  The  font  size  for  the  panels'  titles  */ 

private  static  final  int  PANEE_TITEE_EONT_SIZE  =  17; 

/**  The  font  size  for  the  panels'  labels  */ 

private  static  final  int  PANEE_EABEE_PONT_SIZE  =12; 

/**  The  panels'  font  color  */ 

private  static  final  Color  PONT_COEOR  =  Color.white; 

/**  The  color  of  the  backgroung  of  the  frames  and  panels  */ 

private  static  final  Color  BACKGROUND_COEOR  =  new  Color(  77,  92,  240  ); 

/**  The  color  of  the  panels'  border  */ 

private  static  final  Color  PANEE_BORDER_COEOR  =  Color.blue; 

/**  The  maximum  reconnection  tries  each  time  client  lose  connection*/ 
private  static  final  int  MAX_RECONNECTION_TRIES  =  3; 

/**  The  maximum  reconnection  tries  each  time  client  lose  connection  */ 
private  static  final  int  MAX  TOT AE  TRIES  =  3; 

/**  The  times  tht  the  image  is  updated  in  the  image  progress  panel  */ 
private  static  final  int  IMAGE_UPDATE_TIMES  =  10; 

/**  The  request  type  when  a  file  is  asked  */ 
private  static  final  int  PIEE_REQUEST_TYPE  =  1 ; 


107 


/**  The  request  type  when  a  file  array  is  asked  */ 

private  static  final  int  FILE_ARRAY_REQUEST_TYPE  =  0; 

/**  The  type  for  the  message  dialog  */ 

private  static  final  int  MESSAGE_DIAEOG_TYPE  =  1; 

/**  The  type  for  the  yes-no  dialog  */ 

private  static  final  int  YES_NO_DIAEOG_TYPE  =  0; 

/**  The  message  dialog  OK  option  */ 
private  static  final  int  YES_OPTION  =  1 ; 

/**  The  message  dialog  NO  option  */ 
private  static  final  int  NO_OPTION  =  0; 

/**  The  file  name  of  the  logo  image  of  the  client  frame  */ 
private  static  final  String  EOGO_IMAGE  =  "pftpEogoClient.gif"; 

// 

// 

//  Data  Members  for  the  ETP  Client  functionality: 

// 

// 

/**  The  socket  client  use  to  communicate  with  the  server  */ 
private  Socket  clientSocket; 

/**  The  object  input  stream  to  receive  objects  from  client  */ 
private  ObjectInputStream  inObjectPromServer; 

/**  The  object  output  stream  to  send  objects  to  client  */ 
private  ObjectOutputStream  outObjectToServer; 

/**  The  file  request  received  from  client  */ 
private  PETPEileRequest  filcRequest; 

/**  The  vector  that  store  that  old  partial  file  bytes  */ 
private  Vector  oldPartialTransferRequests; 

/**  The  vector  that  store  that  old  partial  file  bytes  */ 
private  Vector  oldPartialTransfersBytes; 

/**  The  vector  of  the  file  names  that  failed  to  downloaded  */ 
private  Vector  oldPartialTransfersEiles; 

/**  The  vector  list  of  the  files  available  on  PETP  server  */ 
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private  Vector  serverAvailableFiles; 


/**  The  name  of  the  asked  file  */ 
private  String  fileNameToAsk; 

/**  The  server  mode  selected  */ 
private  String  serverMode; 

/**  The  server  selected  */ 
private  String  serverSelected; 

/**  The  hash  value  of  the  file  asked  */ 
private  String  fileHash; 

/**  The  size  in  bytes  of  the  file  asked  */ 
private  int  fileSize; 

/**  The  offset  from  where  we  need  the  file  */ 
private  int  offset; 

/**  The  packet  size  used  for  the  file  transfer  */ 
private  int  packetSize; 

/**  The  file  as  a  byte  array  */ 
private  byte[]  fileluBytes  =  null; 

/**  The  packet  counter  */ 
private  int  packetCounter; 

/**  The  number  of  packets  used  for  the  file*/ 
private  int  numOfPackets; 

/**  The  start  time  of  the  file  reception  */ 
private  long  startTime; 

/**  The  end  time  of  the  file  reception  */ 
private  long  stopTime; 

/**  The  total  file  transfer  time  */ 
private  long  totalFileTransferTime; 

/**  The  connection  status  */ 
private  String  connectionStatus; 

/**  The  connection  loss  times  */ 
private  int  connectionLossTimes; 
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/**  The  connection  loss  times  */ 
private  int  messageOption; 

/**  The  boolean  value  of  the  intetion  of  the  user  to  ask  a  file  */ 
private  boolean  wantFile; 

/**  The  boolean  value  if  the  file  is  transferee!  or  not  */ 
private  boolean  fileTransfered; 

/**  The  boolean  value  the  file  transfer  is  canceled  or  not  */ 
private  boolean  cancelFileTransfer; 

/**  The  boolean  value  if  user  wants  to  retreive  failed  transferred  files  */ 
private  boolean  retrieveFailedTransfers; 

/**  The  file  name  for  the  partial  retreived  file  */ 
private  String  partialRetreivedFileName; 

// 

// 

//  Data  Members  for  the  User  Interface: 

// 

// 

/**  The  container  of  the  main  frame  */ 
private  Container  container; 

/**  The  the  layout  manager  of  the  container  */ 
private  GridLayout  layout; 

/**  The  control  panel  */ 
private  ControlPanel  controlPanel; 

/**  The  panel  that  shows  the  transfer  status  during  downloading  */ 
//private  TransferStatusPanel  transferStatusPanel; 

/**  The  panel  that  displays  the  image  during  the  downloading  */ 
private  ImageProgressPanel  imageProgressPanel; 

/**  The  boolean  tranfering  status  */ 
private  boolean  filelsTransfering  =  false; 

/**  The  boolean  value  if  user  want  to  download  the  file  or  not  */ 
private  boolean  askTheFile  =  false; 


no 


// 

// 

//  Constructor: 

// 

// 

/** 

*  Default  constructor 
*/ 

public  PFTPClientPPC(){ 

super(  "PFTP  PocketPC  1.0" ); 

FrontDialog  fd  =  new  FrontDialog(  this  ); 

//  set  the  layout  of  the  container 
layout  =  new  GridLayout(  1,1); 
setLayout(  layout ); 

//  add  the  panels  on  the  main  frame's  panels 
add(  controlPanel ); 

addWindowListener(  new  WindowListener()  { 
public  void  windowOpened(  WindowEvent  event )  { 

} 

public  void  windowClosed(  WindowEvent  event )  { 
System.exit(  0 ); 

} 

public  void  windowClosing(  WindowEvent  event )  { 
System.exit(  0 ); 

} 

public  void  window Iconified(  WindowEvent  event )  { 

} 

public  void  windowDeiconified(  WindowEvent  event ){ 

} 

public  void  window Activated(  WindowEvent  event )  { 

} 

public  void  windowDeactivated(  WindowEvent  event ){ 

} 
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}); 

//sets  other  attributes  of  the  main  frame 
setSize(  240,  300 ); 
setVisible(  true ); 

//initialization  of  the  private  members 
oldPartialTransferRequests  =  new  Vector(); 
oldPartialTransfersBytes  =  new  Vector(); 
oldPartialTransfersFiles  =  new  Vector(); 
serverAvailableFiles  =  new  Vector(); 

fileNameToAsk  =  null; 
fileSize  =  0; 
packetSize  =  0; 
fileHash  = 

connectionStatus  =  DISCONNECTED; 
retrieveEailedTransfers  =  false; 
connectionEossTimes  =  0; 
totalEileTransferTime  =  0; 
askTheEile  =  false; 

}  //  end  default  constructor 

*  Opens  the  streams  for  communicating  with  the  client 

* 

*  ©throws  lOException  when  the  outpu/input  stream  can  not  be  openned 
*1 

private  void  openStreams()  throws  lOException { 

//  open  the  sreams  needed 

inObjectEromServer  =  new  ObjectInputStream(  clientSocket.getInputStream() ); 
outObjectToServer  =  new  ObjectOutputStream(  clientSocket.getOutputStream() ); 

}  //  end  openStreamsO  method 

/** 

*  Selects  one  from  the  valid  server  to  try  connecting 

* 

*  ©return  a  string  IP  address  of  the  server 
*1 

private  String  selectServer()  { 

String  serverToReturn; 
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double  random  =  10  *  Math.random(); 
int  randomindex  =  ( int )  random; 

serverToRetum  =  VALID_SERVERS [randomindex  %  VAEID_SERVERS. length]; 
return  serverToReturn; 

}  //  end  selectServerO  method 

*  Selects  one  from  the  valid  server  to  try  connecting 

* 

*  ©return  a  string  IP  address  of  the  server 

*  ©throws  lOException 

*  ©throws  ClassNotEoundException 
*1 

private  Vector  getServerAvailableEiles()  throws  lOException, 
ClassNotEoundException  { 

boolean  exit  =  false; 
boolean  connected  =  false; 
int  serverindex  =  0; 

if(  serverMode  ==  "Auto  select" )  { 

while(  ! connected  &&  (  serverindex  <  VAEID_SER VERS. length  ) ){ 
serverSelected  =  VAEID_SER  VERS  [serverindex]; 

System.out.println(  "server  :  "  +  serverSelected  ); 

serverlndex++; 

try] 

clientSocket  =  new  Socket]  serverSelected,  ETP_PORT  ); 
connected  =  true; 

}  catch]  lOException  ioe  )  [ 

}  //end  try  catch  block 
}  //end  while 
if]  !  connected )[ 

clientSocket  =  new  Socket]  serverSelected,  ETP_PORT  ); 

} 

}  else] 

clientSocket  =  new  Socket]  serverMode,  ETP_PORT  ); 

} 

openStreams]); 

connectionStatus  =  CONNECTED; 

filcRequest  =  new  PETPEileRequest]  EIEE_ARRAY_REQUEST_TYPE, 
new  String]), 
new  String]), 

0, 

0); 
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//send  the  file  request  object  to  the  server 
outObjectToServer.writeObject(  fileRequest ); 
outObjectToServer.flushO; 

Vector  filesAtServer  =  (  Vector )  inObjectFromServer.readObject(); 
server AvailableFiles  =  new  Vector(); 
for(  int  i  =  0;  i  <  filesAtServer. size();  i++  ){ 
serverAvailableFiles.add(  filesAtServer.elementAt(  i ) ); 

} 

System.out.println(  "Files  at  server  :  "  +  server  AvailableFiles  ); 
clientSocket.closeO; 

connectionStatus  =  DISCONNECTED; 

return  server AvailableEiles; 

}  //  end  selectServerO  method 

*  Sends  a  file  request  package  to  the  server  asking  for  a  file 

* 

*  @param  fileRequest  the  file  request 

*  ©throws  Exception 
*1 

public  void  askEorEile(  PETPEileRequest  fileRequest )  throws  Exception  { 
//  some  variable  initialization 
boolean  fileNotEound  =  false; 
fileTransfered  =  false; 
cancelEileTransfer  =  false; 
packetCounter  =  0; 
int  byteCounter  =  0; 
int  uumOfBytes  =  1; 
int  percent  =  0; 
numOfPackets  =  1 ; 

fileNameToAsk  =  fileRequest.getEile(); 
boolean  firstiteration  =  true; 

//  create  a  file  to  receive 
fileNameToAsk  =  fileRequest.getEile(); 

Eile  file  =  new  Eile(  fileNameToAsk  ); 

int  connectionCounter  =  1 ; 

int  imagePacketUpdate  =  0; 

int  imagePacketUpdateCounter  =  1 ; 

if(  retrievePailedTransfers  )  { 
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offset  =  fileRequest.getOffsetO; 
fileHash  =  fileRequest.getHash(); 
packetCounter  =  offset; 
numOfPackets  =  packetCounter  +  1 ; 

}  //end  if 

//  The  loop  that  keep  asking  the  file  till  gets  it  all 

while(  IcancelFileTransfer  &&  IfileTransfered  &&  IfileNotFound  && 

( packetCounter  <  numOfPackets )  && 

(  connectionCounter  <=  (  MAX_RECONNECTION_TRIES  * 

MAX_TOTAE_TRIES  ) ) ){ 

System.out.println(  "while" ); 

if(  (  (  MAX_RECONNECTION_TRIES  *  MAX_TOTAE_TRIES  )  % 

connectionCounter )  == 

1){ 

delay ( 2000 ); 

}  else{ 

delay ( 2000 ); 

}  //end  if  else 
connectionCounter++ ; 

try{ 

if(  serverMode.equals(  new  String(  "Auto  select" ) ) ){ 

//select  a  valid  server  to  try  connect 
if(  Ifirstiteration ){ 

serverSelected  =  selectServer(); 


} 

}  else{ 

serverSelected  =  serverMode; 

}  //end  if 

System.out.println(  "Trying  to  connect  to  the  server...."  +  serverMode  ); 
delay(  1000 ); 

//connect  to  the  server  selected  and  set  the  time  out  period 
clientSocket  =  new  Socket(  serverSelected,  ETP_PORT  ); 
clientSocket.setSoTimeout(  SO_TIME_OUT ); 

connectionStatus  =  CONNECTED; 
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System.out.println(  "Client  connected!" ); 
try{ 

openStreamsO; 

}  catch(  Exception  ioe  )  { 

MessagcDialog  md  =  new  MessageDialog(  this, 

controlPanel, 

"**  Exception  **", 

MESSAGE_DIAEOG_TYPE, 

"Client:  Eailed  to  open  streams" ); 

}  //  end  try  catch  block 

fileRequest.setOffset(  offset ); 
fileRequest.setHash(  filcHash ); 

//send  the  file  request  object  to  the  server 
outObjectToServer.writeObject(  filcRequest ); 
outObjectToServer.flushO; 

imageProgressPanel  =  new  ImageProgressPanel(  this ); 
if(  offset  ==  0  ){ 

//receive  the  file  hash  value  if  it  is  asked  for  the  first  time 
fileHash  =  inObjectPromServer.readUTP(); 

System.out.println(  "Hash  value  received  "  +  fileHash  ); 

}  //end  if 

if(  !fileHash.equals(  new  String(  "fileNotPound" ) )  && 

!fileHash.equals(  new  String(  "hashProblem" ) )  && 

!fileHash.equals(  new  String(  "filcNotMatch" ) ) ){ 

//receive  the  file  size  from  the  server 
fileSize  =  inObjectEromServer.readInt(); 

System.out.println(  "Eile  size  to  receive  "  +  fileSize  +  "  bytes" ); 
numOfPackets  =  (  fileSize  /  packetSize  )  +  1 ; 

imagePacketUpdate  =  numOfPackets  /  ( IMAGE_UPDATE_TIMES  -  1 ); 

if(  packetCounter  ==  0  )  { 

//initialize  a  byte  array  for  the  file  bytes 
fileluBytes  =  new  byte[fileSize  +  packetSize]; 

}  else  if(  retrievePailedTransfers  &&  firstiteration  ){ 
firstiteration  =  false; 
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byte[]  partialBytes  =  (  byte[]  )  oldPartialTransfersBytes.elementAt( 
oldPartialTransfersFiles.indexOf(  fileNameToAsk ) ); 
ByteArrayOutputStream  baos  = 

new  ByteArrayOutputStream(  fileSize  +  packets ize  ); 
baos.write(  partialBytes,  0,  partialBytes. length  ); 
fileInBytes  =  baos.toByteArrayO; 
baos.closeO; 

byteCounter  =  packetSize  *  offset; 

}  //end  if  else  if 

byte[]  newPacket  =  new  byte[packetSize]; 
try{ 

if(  packetCounter  ==  0  )  { 
startTime  =  System.currentTimeMillis(); 

}  //end  if 

filelsTransfering  =  true; 

//receiving  the  packets  and  updating  the  file  byte  array 
while/  !cancelFileTransfer  &&  ( packetCounter  <  numOfPackets  ) ){ //end  if 
offset  =  packetCounter; 
inObjectFromServer.read/  newPacket ); 

for(  int  i  =  0;  i  <  packetSize;  i++  ){ 
fileInBytes  [byteCounter  +  i]  =  newPacket[i] ; 

}  //end  for  loop 

System.out.println/  "Bytes  "  +  ( byteCounter  +  1  )  + 

"  to  "  +  ( byteCounter  +  packetSize  )  + 

"  received" ); 

percent  =  ( int )  Math.floor/  ( (  double  )  byteCounter  / 
fileSize  )  *  100  ); 

imageProgressPanel.setTitle/  percent  +  "%  of "  +  fileNameToAsk  + 

"  received!" ); 

if(  (  packetCounter  %  imagePacketUpdate  )  ==  0  )  { 

//update  image  progress  panel 

imageProgressPanel.updatelmageProgress/  fileInBytes ); 

}  //and  if 

delay/  500 ); 

byteCounter  +=  packetSize; 

percent  =  /  int )  Math.floor/  /  /  double  )  byteCounter  / 
fileSize  )  *  100  ); 

if/  percent  >  100  ) 
percent  =100; 
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imageProgressPanel.setTitle(  percent  +  "%  of "  +  fileNameToAsk  + 
"  received!" ); 

packetCounter++ ; 

}  //end  while  loop 

}  catch(  lOException  ioe  ){  //in  case  of  connection  loss 
System.out.println(  "Problem  reading  I/O  Streams" ); 
connectionStatus  =  DISCONNECTED; 
connectionEossTimes++; 

}  //end  try  catch  block 

stopTime  =  System.currentTimeMiIIis(); 

//create  the  file  and  pass  the  byte  array  formed  in  it 
if(  IcancelEileTransfer  &&  packetCounter  ==  numOfPackets  ){ 
fileTransfered  =  true; 
outObjectToServer.writeBooIean(  true ); 
outObjectToServer.flushO; 

if(  file.existsO  ){ 
file.deleteO; 

}  else{ 

imageProgressPaneI.updateImageProgress(  filelnBytes ); 
imageProgressPaneI.updateImageProgress(  filelnBytes ); 

file  =  new  Eile(  fileNameToAsk  ); 

EileOutputStream  editEile  =  new  EiIeOutputStream(  file  ); 
editEiIe.write(  filelnBytes  ); 
totalEileTransferTime  =  stopTime  -  startTime; 
editEile. closeO; 
if(  retrieveEailedTransfers  ){ 
deIetePartiaIEiIeRequest(  fileNameToAsk ); 
retrieveEailedTransfers  =  false; 
deIetePartiaIEiIeRequest(  fileNameToAsk ); 

}  //end  if 

MessageDialog  md  =  new  MessageDiaIog(  this, 
controIPanel, 

"**  Message  **", 

MESSAGE_DIAEOG_TYPE, 

"Eile  transfered  in  "  + 
totalEileTransferTime  +  "  msec!" ); 
if(  oIdPartiaITransfersEiIes.contains(  fileNameToAsk  ) ){ 
int  index  =  oIdPartiaITransfersEiIes.indexOf(  fileNameToAsk  ); 
oIdPartiaITransferRequests.removeEIementAt(  index ); 
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oldPartialTransfersBytes.removeElementAt(  index ); 
oldPartialTransfersFiles.removeElementAt(  index ); 

} 

imageProgressPanel.setVisible(  false ); 
resetApplicationO; 

} 

}  else{ 

System.out.println(  "Eile:  "  +  fileNameToAsk  + 

"  transfer  interrupted!" ); 

}  //end  if  else 
}  else{ 

System.out.println(  "Server  doesn't  have  the  file  version  asked!" ); 

}  //end  if  else 

try{ 

System.out.println(  "Close  socket" ); 
clientSocket.closeO ; 

}  catch(  lOException  ioe  )  { 

}  //end  try  catch  block 
}  catch(  Exception  ce  ){ 

connectionStatus  =  TRYING_TO_CONNECT; 

if(  connectionCounter  ==  (  MAX_RECONNECTION_TRIES 

MAX_TOTAE_TRIES  +  1  ) ){ 

MessageDialog  md  =  new  MessageDialog(  this, 

controlPanel, 

"**  ERROR  **", 

MESSAGE_DIAEOG_TYPE, 

"The  server  couldn't  be  reached  " ); 

}  //end  if 

}  //end  try  catch  block 
}  //end  while  loop 

if(  !fileTransfered  &&  !cancelEileTransfer  ){ 
fileRequest.setOffset(  offset ); 
fileRequest.setHash(  fileHash ); 
savePartialEileRequest(  fileRequest, 
fileInBytes  ); 

MessageDialog  md  =  new  MessageDialog(  this, 

controlPanel, 

"**  ERROR  **", 
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MESSAGE_DIALOG_TYPE, 

"Transfer  failed.Partial  data  stored!" ); 

}  //end  if 

}  //end  askPorPileO  method 

*  Cancels  the  file's  transfer 
*1 

public  void  cancelPileTransfer()  { 
cancelPileTransfer  =  true; 

}  //end  setPileNameToAskO  method 

*  Sets  the  file  name  to  ask  the  server 

* 

*  @param  fileName  the  string  file  name 
*/ 

public  void  setPileNameToAsk(  String  fileName  ){ 
fileNameToAsk  =  fileName; 

}  //end  setPileNameToAskO  method 

/** 

*  Starts  the  file  dowmnloading 

* 

*  @param  ask  true  if  the  ask  the  file  button  is  pressed 
*1 

public  void  setAskThePile(  boolean  ask )  { 
askThePile  =  ask; 

}  //end  SetPileNameToAskO  method 

*  Sets  the  server  mode  of  the  file  transfer 

* 

*  @param  mode  the  string  server  mode 
*t 

public  void  setServerMode(  String  mode  )  { 
serverMode  =  mode; 

}  //end  setServerModeO  method 

*  Sets  the  packet  size  for  the  file  transfer 

* 

*  @param  sizeOfThePacket  the  packet  size  selected  for  the  file  transfer 
*1 
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public  void  setPacketSize(  int  sizeOfThePacket )  { 
packetSize  =  sizeOfThePacket; 

}  //end  setPacketSizeO  method 

*  Sets  the  offset  for  the  file  transfer 

* 

*  @param  theOffset  the  offset  value 
*/ 

public  void  setOffset(  int  theOffset )  { 
offset  =  theOffset; 

}  //end  setPacketSizeO  method 

*  Returns  the  name  of  the  file  asked  from  the  server 

* 

*  ©return  the  name  of  the  file  asked  from  the  server 
*1 

public  synchronized  String  getServerMode()  { 
notify  0; 

return  serverMode; 

}  //end  getFileNameToAskO  method 

/** 

*  Returns  the  name  of  the  file  asked  from  the  server 

* 

*  ©return  the  name  of  the  file  asked  from  the  server 
*1 

public  synchronized  String  getFileNameToAsk(){ 
notify/); 

return  fileNameToAsk; 

}  //end  getFileNameToAskO  method 

*  Returns  the  size  of  the  file  asked  from  the  server 

* 

*  ©return  the  size  of  the  file  asked  from  the  server 
*1 

public  synchronized  int  getPacketSize/)  { 
notify/); 

return  packetSize; 

}  //end  getPacketSize/)  method 

/** 

*  Returns  the  size  in  bytes  of  the  file  asked 

* 
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*  ©return  the  size  in  bytes  of  the  file  asked 
*/ 

public  synchronized  int  getFileSize()  { 
notify  0; 
return  fileSize; 

}  //end  getFileSizeO  method 

*  Returns  the  number  of  packet  needed  for  the  transfer 

* 

*  ©return  the  number  of  packets  need  for  the  transfer 
*1 

public  synchronized  int  getNumOfPackets(){ 
notify/); 

return  numOfPackets; 

}  //end  getNumOfPacketsO  method 

*  Returns  the  number  of  packet  already  received 

* 

*  ©return  the  number  of  packet  already  received 
*1 

public  synchronized  int  getReceivedPackets(){ 
notify/); 

return  packetCounter; 

}  //end  getReceivedPackets/)  method 

/** 

*  Returns  the  file  bytes  as  byte  array 

* 

*  ©return  the  file  bytes  as  byte  array 
*1 

public  synchronized  byte[]  getFileInBytes/){ 
notify/); 

return  fileInBytes; 

}  //end  getFileInBytes/)  method 

*  Returns  the  connection  status 

* 

*  ©return  the  connection  status 
*1 

public  synchronized  String  getConnectionStatus/){ 
notify/); 

return  connectionStatus; 

}  //end  getConnectionStatus/)  method 
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*  Returns  the  connection  loss  times 

* 

*  ©return  the  connection  loss  times 
*1 

public  synchronized  int  getConnectionLossTimes(){ 
notify  0; 

return  connectionLossTimes; 

}  //end  getConnectionLossTimesO  method 

/** 

*  Returns  the  total  file  transfer  time 

* 

*  ©return  the  total  file  transfer  time 
*1 

public  synchronized  long  getTotalFileTransferTime()  { 
notify  0; 

return  totalFileTransferTime; 

}  //end  getTotalFileTransferTimeO  method 

*  Returns  the  total  file  transfer  time 

* 

*  ©return  the  total  file  transfer  time 
*1 

public  synchronized  boolean  getFileTransfered()  { 
notify  0; 

return  fileTransfered; 

}  //end  getFileTransferedO  method 

/** 

*  Returns  the  control  panel 

* 

*  ©return  the  control  panel 
*1 

public  synchronized  ControlPanel  getControlPanel()  { 
notify  0; 

return  controlPanel; 

}  //end  getControlPanelO  method 

/** 

*  Adds  a  panel  to  a  container 

* 

*  ©param  container  the  container  to  add  the  panel 
*1 
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public  void  addPanel(  Container  container  )  { 

Panel  dummy  =  new  Panel(); 

dummy. setBackground(  BACKGROUND_COLOR ); 
container.  add(  dummy ); 

}  //end  addPanelO  method 

*  Saves  a  partial  file  request  to  file  request  database  for  future  use 

* 

*  @param  partialFileRequest  the  partial  file  request  to  save  in  database 

*  @param  partialFileBytes  the  partial  file  bytes  to  save  in  database 
*1 

public  void  savePartialFileRequest(  PFTPFileRequest  partialFileRequest, 
byte[]  partialFileBytes  ){ 

oldPartialTransfersFiles.addElement(  partialFileRequest.getFile() ); 
oldPartialTransferRequests.addElement(  partialEileRequest ); 
oldPartialTransfersBytes.addElement(  partialEileBytes ); 

//oldPartialTransfersEileSizes.add(new  Integer(partialEileOverallSize)); 

}  //end  savePartialEileRequestO  method 

/** 

*  Deletes  a  partial  file  request  from  file  request  database 

* 

*  @param  partialEileNameRequested  the  name  of  the  file  of  the 

*  request  to  delete  from  database 
*/ 

public  void  deletePartialEileRequest(  String  partialEileNameRequested ){ 

oldPartialTransferRequests.removeElement(  partialEileNameRequested ); 
oldPartialTransfersBytes.removeElement(  partialEileNameRequested ) ; 
oldPartialTransfersEiles  .removeElement(  partialEileNameRequested ) ; 

}  //end  deletePartialEileRequestO  method 

*  Resets  the  client  application 
*/ 

public  void  resetApplication()  { 

fileSize  =  0; 
fileHash  = 

connectionStatus  =  DISCONNECTED; 
connectionEossTimes  =  0; 
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totalFileTransferTime  =  0; 


controlPanel.resetO ; 

}  //end  resetApplicationO  method 

*  Starts  chack  for  start  downloading 
*/ 

public  void  startCheckToAsk(){ 
while(  true )  { 
delay(  50 ); 
if(  askTheFile )  { 
try{ 

System.out.println(  "File  asked" ); 
askForFile(  fileRequest ); 

}  catch(  Exception  e  ){ 

} 

askTheFile  =  false; 

} 

} 

}  //end 

*  Delay  the  execution  of  the  code 

* 

*  @param  msec  the  delay  time  in  milliseconds 
*/ 

public  void  delay(  int  msec  )  { 
try{ 

Thread.sleep(  msec  ); 

}  catch(  InterruptedException  ie  )  { 

System.out.println(  "Thead  sleep  interupted" ); 

} 

}  //end  delayO  method 

*  The  main  method 

* 

*  @param  args  the  arguments 

*  ©throws  Exception  if  exception  occurs  in  ETPClient  application 
*1 

public  static  void  main(  String  args[]  )  throws  Exception  { 
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PFTPClientPPC  client  =  new  PFTPClientPPC(); 
client.startCheckToAskO; 

}  //end  main  method 


// 

// 

//  Private  Inner  Classes: 

// 

// 

*  Provide  a  control  panel  to  control  the  application 
*1 

private  class  ControlPanel  extends  Panel{ 

/**  The  PFTPClient  class  object  */ 
private  PFTPClientPPC  controlPanelClient; 

/**  The  panel  that  displays  the  image  during  the  downloading  */ 
private  ImageProgressPanel  imagePanel; 

/**  The  control  panel  title  */ 
private  Panel  controlPanelTitle; 

/**  The  file  choice  dialog  */ 

private  FileSelectionDialog  fileChoiceDialog; 

/**  The  file  choice  label  */ 
private  Label  fileChoiceLabel; 

/**  The  server  mode  choice  list  */ 
private  java.awt.List  serverModeChoiceList; 

/**  The  packet  size  choice  list  */ 
private  java.awt.List  packets izeChoiceList; 

/**  The  file  button  group  */ 

private  CheckboxGroup  fileButtonGroup; 

/**  The  server  button  group  */ 

private  CheckboxGroup  serverButtonGroup; 

/** 

*  The  previous  failed  files  Checkbox 
*/ 
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private  Checkbox  previousFailedFiles; 


*  The  files  from  server  Checkbox 
*/ 

private  Checkbox  filesFromServer; 

*  The  manual  server  selection  Checkbox 
*1 

private  Checkbox  manualServerSelection; 

*  The  predefined  server  selection  Checkbox 
*1 

private  Checkbox  predefinedServerSelection; 

/**  The  select  server  button  */ 
private  Button  selectServer; 

/**  The  button  to  retreive  the  availiable  file  at  PFTP  Server  */ 
private  Button  retreiveAvailableFiles; 

/**  The  button  to  ask  for  the  file  transfer  */ 
private  Button  askTheFile; 

/**  The  button  to  cancel  the  file  transfer  */ 
private  Button  cancelTransfer; 

/**  The  text  field  to  enter  manual  the  server  to  ask  the  file  from  */ 
private  TextField  manualSelectServer; 

/**  The  server  IP  array  with  servers  can  be  chosen  */ 
private  String[]  serverlPs  =  {"Select  server",  "Auto  select", 

"127.0.0.1",  "131.120.105.237",  "131.120.105.250",  "131.120.201.46"}; 

/**  The  packet  size  array  with  the  packet  sizes  can  be  chosen  */ 
private  String[]  packets izes  =  ("Packet  size..", 

new  String}  "32" ),  new  String}  "64" ),  new  String}  "128" ), 
new  String}  "256" ),  new  String}  "512" ),  new  String}  "1024" )}; 

/**  The  file  selected  */ 
private  String  fileSelection; 

/**  The  server  selected  */ 
private  String  serverSelection; 
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/**  The  packet  size  selected  */ 
private  String  packetSizeSelection; 

/**  The  boolean  value  if  a  file  selected  or  not  */ 
private  boolean  fileSelected  =  false; 

/**  The  boolean  value  if  a  server  selected  or  not  */ 
private  boolean  serverSelected  =  false; 

/**  The  boolean  value  if  a  packet  size  selected  or  not  */ 
private  boolean  packetSizeSelected  =  false; 

*  The  default  constructor 

* 

*  @param  panelClient  the  FTPClientVer?  object  assosiated  with 

*  @param  imagePanel  the  ImageProgressPanel  object  assosiated  with 
*1 

public  ControlPanel(  PFTPClientPPC  panelClient, 
ImageProgressPanel  imagePanel ){ 


superO; 

serverlPs  =  new  String[VALID_SER VERS. length  +  2]; 
for(  int  i  =  0;  i  <  serverlPs. length;  i++  ){ 
if(i==0){ 

serverIPs[i]  =  "Select  server"; 

}  else  if(  i  ==  1  ){ 

serverIPs[i]  =  "Auto  select"; 

}  else{ 

serverIPs[i]  =  VAEID_SERVERS[i  -  2]; 

}  //end  if  else  if 
}  //end  for  loop 

packets izes  =  new  String[PACKET_SIZES. length  +  1]; 
for(  int  i  =  0;  i  <  packets  izes. length;  i++  ){ 
if(i==0){ 

packets  izes  [i]  =  "Select  packet  size"; 

}  else{ 

packetSizes[i]  =  PACKET_SIZES[i  -  1]; 

}  //end  if  else  if 
}  //end  for  loop 

controlPanelClient  =  panelClient; 
imagePanel  =  imagePanel; 
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setBackground(  BACKGROUND_COLOR ); 
setLayout(  new  GridLayout(  12,  2  ) ); 

Label  controlPanelTitle  =  new  Label(  "CONTROL  PANEL" ); 
controlPanelTitle.setFont(  new  Font(  "Serif",  Font.BOFD,  13  ) ); 
controlPanelTitle. setForeground(  FONT_COFOR ); 
add(  controlPanelTitle ); 

//  just  to  fill  the  empty  cells 
controlPanelClient.addPanel(  this ); 

//  construct  textfield  with  default  sizing 
Fabel  fileToReceive  =  new  Fabel(  "File  to  retreive:" ); 
fileToReceive.setFont(  new  Font(  "Serif",  Font.BOFD,  13  ) ); 
fileToReceive. setForeground(  FONT_COFOR ); 
add(  fileToReceive ); 

fileButtonGroup  =  new  CheckboxGroupO; 

previousFailedFiles  =  new  Checkbox(  "Failed  transfers",  fileButtonGroup,  false  ); 
previousFailedFiles.setFont(  new  Font(  "Serif",  Font.BOFD,  12  ) ); 
previousFailedFiles. setForeground(  FONT_COFOR ); 
filesFromServer  =  new  Checkbox(  "Files  on  server",  fileButtonGroup,  true  ); 
filesFromServer.setFont(  new  Font(  "Serif",  Font.BOFD,  12  ) ); 
filesFromServer.setForeground(  FONT_COFOR ); 

//inner  class  to  handle  JRadioButton  events 
ItemFistener  fileMode  =  new  ItemListener()  { 

//  handle  Checkbox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event.getSourceO  ==  previousFailedFiles  ){ 

String[]  fileFist  =  new  String[oldPartialTransfersFiles.size()  +  1]; 
for(  int  i  =  0;  i  <  fileFist.length;  i++  ){ 
if(i==0){ 

fileFist[i]  =  "Select  file"; 

}  else{ 

fileFist[i]  =  (  String  )  oldPartialTransfersFiles.elementAt(  i  - 

1); 

}  //end  if  else 
}  //end  for  loop 

if(  loldPartialTransfersFiles.isEmptyO  ){ 
retrieveFailedTransfers  =  true; 

fileChoiceDialog  =  new  FileSelectionDialog(  controlPanelClient, 
controlPanelClient.getControlPanelO, 
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fileChoiceLabel, 
fileList ); 

packets  izeSelected  =  true; 

}  else  if(  oldPartialTransfersFiles.isEmptyO  ){ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
controlPanel, 

"**  Message  **", 

MESSAGE_DIALOG_TYPE, 

"No  file  transfer  failure  by  now!" ); 
manualServerSelection.setEnabled(  false ); 
predefinedServerSelection.setEnabled(  false ); 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceEist.setEnabled(  false ); 
retreiveAvailableEiles.setEnabled(  false ); 
packets izeChoiceEist.setEnabled(  false ); 
askTheEile.setEnabled(  false ); 


} 

}  else  if(  event.getSourceO  ==  filesEromServer ){ 
manualServerSelection.setEnabled(  true ); 
predefinedServerSelection.setEnabled(  true ); 
serverModeChoiceEist.setEnabled(  true ); 
askTheEile.setEnabled(  true ); 

}  //end  if  else 
}  //end  itemstateChanged 

} ;  //  end  anonymous  inner  class 

previousEailedEiles.addItemListener(  fileMode ); 
previousEailedEiles.setBackground(  BACKGROUND_COEOR ); 

filesEromServer.  addItemEistener(  fileMode ); 
filesEromServer.setBackground(  BACKGROUND_COEOR ); 

add(  previousEailedEiles  ); 

controlPanelClient.  addPanel(  this ); 

add(  filesEromServer ); 

Eabel  serverToReceiveErom  =  new  Eabel(  "Server  choice:" ); 
serverToReceiveErom.setEont(  new  Eont(  "Serif",  Eont.BOED,  13  ) ); 
serverToReceiveErom.  setEoreground(  EONT_COEOR ); 
add(  serverToReceiveErom ); 
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serverButtonGroup  =  new  CheckboxGroupO; 
manualServerSelection  =  new  Checkbox(  "Manual  Selection", 

serverButtonGroup,  false ); 

predefinedServerSelection  =  new  Checkbox(  "Existing  Servers", 

serverButtonGroup,  true ); 

//inner  class  to  handle  JRadioButton  events 
ItemListener  serverListener  =  new  ItemListener()  { 

//  handle  Checkbox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event.getSourceO  ==  manualServerSelection  ){ 
manualSelectServer.setEnabled(  true ); 
serverModeChoiceEist.setEnabled(  false ); 
selectServer.setEnabled(  true ); 

}  else  if(  event. getSourceO  ==  predefinedServerSelection  ){ 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceEist.setEnabled(  true ); 

}  //end  if  else 
}  //end  itemstateChanged 

};  //  end  anonymous  inner  class 

manualServerSelection. addItemEistener(  serverEistener ); 
manualServerSelection. setBackground(  BACKGROUND_COEOR ); 
manualServerSelection. setEont(  new  Eont(  "Serif",  Eont.BOED,  12  ) ); 
manualServerSelection. setEoreground(  EONT_COEOR ); 

predefinedServerSelection. addItemEistener(  serverEistener ); 
predefinedServerSelection. setBackground(  BACKGROUND_COEOR ); 
predefinedServerSelection. setEont(  new  Eont(  "Serif",  Eont.BOED,  12  ) ); 
predefinedServerSelection. setEoreground(  EONT_COEOR ); 

add(  manualServerSelection ); 

controlPanelClient.addPanel(  this ); 

add(  predefinedServerSelection ); 

Eabel  addServerIP  =  new  Eabel(  "Select  server  IP:" ); 
addServerIP.setPont(  new  Pont(  "Serif",  Eont.BOED,  13  ) ); 
addServerIP. setEoreground(  PONT_COEOR ); 
add(  addServerIP ); 
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manualSelectServer  =  new  TextField(  "Enter  server  IP" ); 
addServerIP.setFont(  new  Font(  "Serif",  Font.BOFD,  13  ) ); 
manualSelectServer.  setEditable(  true ); 
manualSelectServer.  setEnabled(  false ); 
add(  manualSelectServer ); 

controlPanelClient.addPanel(  this  ); 

//  constructs  the  add  server  button 
selectServer  =  new  Button(  "Select  the  server" ); 

selectServer.setFont(  new  Font(  "Serif",  Font.BOFD,  PANEF_FABEF_FONT_SIZE 

selectServer. setForeground(  FONT_COEOR ); 
selectServer.setBackground(  BACKGROUND_COEOR ); 
selectServer.  setEnabled(  false ); 

selectServer.addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 

try{ 

String  serverIP  =  manualSelectServer.getText(); 

InetAddress.getByName(  serverIP ); 
if(  IretrieveFailedTransfers  ){ 
retreiveAvailableFiles.setEnabled(  true ); 

} 

packets izeChoiceEist.setEnabled(  false ); 
controlPanelClient.setServerMode(  serverIP ); 
serverSelected  =  true; 

}  catch(  UnknownHostException  uhe  ){ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 

controlPanel, 

"**  INFORMATION  **", 

MESSAGE_DIAEOG_TYPE, 

"Select  a  valid  server  IP  address!" ); 

} 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

add(  selectServer ); 

Eabel  chooseServerMode  =  new  Eabel(  "Server  mode:" ); 
chooseServerMode.setFont(  new  Font(  "Serif",  Font.BOFD,  13  ) ); 
chooseServerMode. setForeground(  FONT_COEOR ); 
add(  chooseServerMode ); 
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serverModeChoiceList  =  new  java.awt.List(  4,  false  ); 
for(  int  i  =  0;  i  <  serverlPs. length;  i++  ){ 
serverModeChoiceList.add(  serverlPs [i] ); 

} 

serverModeChoiceList. setFont(  new  Font(  "Serif",  Font.BOLD, 

PANEL_LABEL_FONT_SIZE ) ); 
serverModeChoiceEist.setBackground(  BACKGROUND_COEOR ); 
serverModeChoiceEist.setEoreground(  EONT_COEOR ); 
serverModeChoiceEist.setEnabled(  true ); 
serverModeChoiceEist.addItemEistener( 

//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemListenerO  { 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event. gets tateChangeO  ==  ItemEvent.  SEEECTED  ){ 
serverSelection  =  serverModeChoiceEist.getSelectedItem(); 
serverSelected  =  true; 
if(  IretrieveEailedTransfers  ){ 
retreiveAvailableEiles.setEnabled(  true ); 

} 

} 

controlPanelClient.setServerMode(  serverSelection ); 

} 

}  //  end  anonymous  inner  class 

);  //  end  call  to  addItemEistener 
add(  serverModeChoiceEist ); 

controlPanelClient.addPanel(  this ); 

//  constructs  the  Retreive  files  button 
retreiveAvailableEiles  =  new  Button(  "Retreive  files..  " ); 
retreiveAvailableEiles.setEont(  new  Eont(  "Serif",  Eont.BOED, 

PANEE_EABEE_EONT_SIZE ) ); 
retreiveAvailableEiles. setEoreground(  EONT_COEOR ); 
retreiveAvailableEiles. setBackground(  BACKGROUND_COEOR ); 
retreiveAvailableEiles. addActionEistener(  new  ActionEistener(){ 
public  void  actionPerformed(  ActionEvent  event )  { 
try{ 

serverAvailableEiles  =  controlPanelClient.getServerAvailableEiles() ; 
retreiveAvailableEiles. setEnabled(  false ); 
if(  !serverAvailableEiles.isEmpty() ){ 

String[]  fileEist  =  new  String[serverAvailableEiles.size()  +  1]; 
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for(  int  i  =  0;  i  <  fileList.length;  i++  ){ 
if(i==0){ 

fileList[i]  =  "Select  file"; 

}  else{ 

fileList[i]  =  (  String  )  serverAvailableFiles.elementAt(  i  - 

1); 

}  //end  if  else 
}  //end  for  loop 

fileChoiceDialog  =  new  FileSelectionDialog(  controlPanelClient, 
controlPanelClient.getControlPanelO, 
fileChoiceLabel, 
fileList ); 

packets izeChoiceList.setEnabled(  true ); 

}  else{ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
controlPanel, 

"**  INFORMATION  **", 

MESSAGE_DIALOG_TYPE, 

"No  files  availiable  at  server" ); 

}  //end  if  else 

}  catch(  lOException  ioe  )  { 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 

controlPanel, 

"**  ERROR  **", 
MESSAGE_DIAEOG_TYPE, 

"Eail  to  retreive  file  list" ); 

retreiveAvailableEiles.setEnabled(  false ); 

}  catch(  ClassNotEoundException  cnfe  )  { 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 

controlPanel, 

"**  ERROR  **", 
MESSAGE_DIAEOG_TYPE, 

"Unknown  object  received" ); 


}  //end  try  catch  block 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

retreiveAvailableEiles.setEnabled(  false ); 
add(  retreiveAvailableEiles  ); 

Eabel  fileWhichSelected  =  new  Eabel(  "Eile  selected 
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fileWhichSelected.setFont(  new  Font(  "Serif",  Font.BOLD,  13  ) ); 
fileWhichSelected.setForeground(  FONT_COLOR ); 
add(  fileWhichSelected ); 

fileChoiceLabel  =  new  Label(  "No  file  selected" ); 
fileChoiceLabel.setFont(  new  Font(  "Serif",  Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
fileChoiceEabel.setBackground(  BACKGROUND_COEOR ); 
fileChoiceEabel.setEoreground(  EONT_COEOR ); 

add(  fileChoiceEabel ); 

controlPanelClient.addPanel(  this ); 

packetSizeChoiceEist  =  new  java. awt.Eist(  4,  false  ); 
for(  int  i  =  0;  i  <  packets izes. length;  i++  ){ 
packets  izeChoiceEist.add(  packets  izes  [i] ); 

} 

packetSizeChoiceEist.setEont(  new  Eont(  "Serif",  Eont.BOED, 

PANEE_EABEE_EONT_SIZE ) ); 
packetSizeChoiceEist.setBackground(  BACKGROUND_COEOR ); 
packetSizeChoiceEist.  setEoreground(  EONT_COEOR ); 
packetSizeChoiceEist.  setEnabled(  true ); 
packets  izeChoiceEist.addItemEistener( 

//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemListenerO  { 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event.getStateChangeO  ==  ItemEvent.SEEECTED  ){ 
packets  izeSelection  =  packets  izeChoiceEist.getSelectedItem(); 
System.out.println(  "packet  size..  "  +  packetSizeSelection  ); 
controlPanelClient.setPacketSize(  new  Integer(  packetSizeSelection  ). 
intValueO  ); 

packets  izeSelected  =  true; 

} 


} 

}  //  end  anonymous  inner  class 
);  //  end  call  to  addItemEistener 
packets izeChoiceEist.setEnabled(  false ); 


135 


add(  packets  izeChoiceList ); 

//  constructs  the  download  button 
askTheFile  =  new  Button(  "Download" ); 

askTheFile.setFont(  new  Font(  "Serif",  Font.BOLD,  PANEL_LABEL_FONT_SIZE  ) 

); 

askTheEile.setEoreground(  EONT_COEOR ); 

askTheEile.setBackground(  BACKGROUND_COEOR ); 
askTheEile.addActionEistener(  new  ActionEistener()  { 
public  void  actionPerfonned(  ActionEvent  event )  { 
if(  fileSelected  &&  serverSelected  &&  packetSizeSelected )  { 
filesEromServer.setEnabled(  false ); 
previousEailedEiles.setEnabled(  false ); 
manualServerSelection.setEnabled(  false ); 
predefinedServerSelection.setEnabled(  false ); 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceEist.setEnabled(  false ); 
retreiveAvailableEiles.setEnabled(  false ); 
packets izeChoiceEist.setEnabled(  false ); 
askTheEile.setEnabled(  false ); 
cancelTransfer.setEnabled(  true ); 

controlPanelClient.setOffset(  0 ); 
fileSelection  =  fileChoiceEabel.getText(); 

if(  IretrieveEailedTransfers  ){ 

fileRequest  =  new  PETPEileRequest(  EIEE_REQUEST_TYPE, 
fileSelection, 
new  String( "" ),  0, 
new  Integer( 
packets izeSelection ). 

intValueO  ); 

}  else{ 

fileRequest  =  (  PETPEileRequest ) 
oldPartialTransferRequests.elementAt( 
oldPartialTransfersEiles.indexOf(  fileSelection ) ); 

} 

try{ 

controlPanelClient.setAskTheEile(  true ); 

System.out.println(  "Download  pressed" ); 

}  catch(  Exception  e  )  { 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
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controlPanel, 

"**  ERROR  **", 

MESSAGE_DIALOG_TYPE, 

"Problem  in  asking  the  file" ); 

}  //end  try  catch  block 

}  else  if(  !fileSelected  ){ 

if(  serverSelected  &&  packets izeSelected )  { 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
controlPanel, 

"**  INEORMATION  **", 

MESSAGE_DIAEOG_TYPE, 

"Select  server!" ); 

}  elseif(  !  serverSelected  &&  IpacketSizeSelected )  { 
MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
controlPanel, 

"**  INEORMATION  **", 

MESSAGE_DIAEOG_TYPE, 

"Select  server,file,packet  size!" ); 

}  else  if(  !  serverSelected  ){ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
controlPanel, 

"**  INEORMATION  **", 

MESSAGE_DIAEOG_TYPE, 

"Select  file  and  server!" ); 

}  else  if(  !packetS izeSelected  ){ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
controlPanel, 

"**  INEORMATION  **", 

MESSAGE_DIAEOG_TYPE, 

"Select  file  and  packet  size!" ); 

}  //end  if  else  if 

}  else  if(  serverSelected  &&  !packetS izeSelected  ){ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 

controlPanel, 

"**  INEORMATION  **", 
MESSAGE_DIAEOG_TYPE, 

"Select  packet  size!" ); 

}  else  if(  !  serverSelected  &&  packets  izeSelected  ){ 

MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 
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controlPanel, 

"**  INFORMATION  **", 
MESSAGE_DIALOG_TYPE, 

"Select  server  !" ); 

}  else  if(  !serverSelected  &&  !packetSizeSelected  ){ 
MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 

controlPanel, 

"**  INEORMATION  **", 
MESSAGE_DIAEOG_TYPE, 

"Select  server  and  packet  size!" ); 

}  //end  if  else  if 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

add(  askTheEile ); 

//  constructs  the  cancel  transfer  button 
cancelTransfer  =  new  Button(  "Cancel  Download" ); 
cancelTransfer.setEont(  new  Eont(  "Serif",  Eont.BOED, 
PANEE_EABEE_EONT_SIZE ) ); 
cancelTransfer.setEoreground(  EONT_COEOR ); 
cancelTransfer. setBackground(  BACKGROUND_COEOR ); 
cancelTransfer.setEnabled(  false ); 

cancelTransfer.addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
MessageDialog  md  =  new  MessageDialog(  controlPanelClient, 

controlPanel, 

"**  WARNING  **", 
YES_NO_DIAEOG_TYPE, 

"Are  you  sure  ?" ); 

if(  messageOption  ==  YES_OPTION  ){ 
controlPanelClient.cancelEileTransferO; 
imageProgressPanel.setVisible(  false ); 
resetApplicationO ; 
messageOption  =  NO_OPTION; 

}  //end  if 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

add(  cancelTransfer ); 
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setVisible(  true ); 

}  //end  constructor 

*  Sets  the  fileSelected  value 

* 

*  @param  state  the  the  fileSelected  boolean  value 
*/ 

public  void  setFileSelected(  boolean  state  )  { 
fileSelected  =  state; 

}  //end  setFileSelectedO  method 

*  Resets  the  panel 
*/ 

public  void  reset()  { 

filesFromServer.setEnabled(  true ); 
filesFromServer.setState(  true ); 
previousFailedFiles.setEnabled(  true ); 
manualServerSelection.setEnabled(  true ); 
predefinedServerSelection.setEnabled(  true ); 
predefinedServerSelection.setState(  true ); 
manualSelectServer.setEnabled(  false ); 
selectServer.setEnabled(  false ); 
serverModeChoiceEist.setEnabled(  true ); 
retreiveAvailableEiles.setEnabled(  false ); 
packets izeChoiceEist.setEnabled(  false ); 
askTheEile.setEnabled(  true ); 
cancelTransfer.setEnabled(  false ); 
fileSelected  =  false; 
serverSelected  =  false; 
packetSizeSelected  =  false; 
filelsTransfering  =  false; 

}  //end  reset()  method 
}  //end  ControlPanel  class 

*  Provide  a  image  progress  panel  to  view  the  partial  file  transferred 
*1 

private  class  ImageProgressPanel  extends  Dialog! 
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/**  The  The  PFTPClient  object  assosiated  with  this  panel  */ 
private  PFTPClientPPC  imageProgressPanelClient; 

/**  The  image  canvas  */ 
private  PFTPCanvas  imageCanvas; 

/**  The  image  canvas  dimension  */ 
private  Dimension  imageCanvasDimension; 

/**  The  updated  times  */ 
private  int  updatedTimes; 

/**  The  file  name  to  preview  */ 
private  String  fileNameToPreview; 

*  Constructor 

* 

*  @param  client  the  PFTPClient  object  assosiated  with  this  panel 
*1 

public  ImageProgressPanel(  PFTPClientPPC  client ){ 
super(  client,  "0%  of "  +  client.getFileNameToAsk()  + 

"  received!",  false ); 

addWindowListener(  new  Window Listener(){ 
public  void  windowOpened(  WindowEvent  event )  { 

} 

public  void  windowClosed(  WindowEvent  event ){ 
setVisible(  false ); 

} 

public  void  windowClosing(  WindowEvent  event )  { 
setVisible(  false ); 

} 

public  void  window Iconified(  WindowEvent  event )  { 

} 

public  void  windowDeiconified(  WindowEvent  event ){ 

} 

public  void  window Activated(  WindowEvent  event )  { 

} 

public  void  windowDeactivated(  WindowEvent  event )  { 

} 
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}); 

imageProgressPanelClient  =  client; 

imageCanvas  =  new  PFTPCanvas(); 
imageCanvasDimension  =  null; 

imageCanvas.setBackground(  BACKGROUND_COLOR ); 

updatedTimes  =  0; 

fileNameToPreview  =  null; 

setBackground(  BACKGROUND_COLOR ); 

setSize(  240,  270 ); 

setLayout(  new  GridLayout(  1,1)); 

add(  imageCanvas ); 

show(); 

}  //end  constructor 

*  Updates  the  iamage  progress  panel 

* 

*  @param  fileBytes  the  file  byte  array  to  display 
*/ 

public  void  updateImageProgress(  byte[]  fileBytes  ){ 

ImageCanvasDimension  =  imageCanvas. getSize(); 

Image  image  = 

Toolkit.getDefaultToolkit().createImage(  fileBytes  ). 
getScaledInstance( 

-1,  imageCanvasDimension.height, 

Image.SCALE_FAST ); 

imageCanvas. setlmage(  image ); 
imageCanvas.update(  imageCanvas. getGraphics() ); 

}  ///end  updatelmageProgressO  method 

}  //end  ImageProgress  class 

*  The  front  dialog 
*1 

private  class  FrontDialog  extends  Dialog) 
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/**  The  dialog  client  */ 

private  PFTPClientPPC  dialogClient; 

/**  The  dialog  control  panel  */ 
private  ControlPanel  dialogControlPanel; 

/**  The  dialog  text  field  */ 
private  Label  dialogTextField; 

/**  The  image  canvas  */ 
private  PFTPCanvas  imageCanvas; 

/**  The  image  canvas  dimension  */ 
private  Dimension  imageCanvasDimension; 

/**  The  button  to  use  the  program  */ 
private  Button  useltButton; 

*  Constructor 

* 

*  @param  client  the  PFTPClientPPC  object  assosiated  with 
*1 

public  FrontDialog(  PFTPClientPPC  client )  { 
super(  client,  "PFTP  PocketPC  Client  1.0",  true  ); 

addWindowListener(  new  Window Listener(){ 
public  void  windowOpened(  WindowEvent  event )  { 

} 

public  void  windowClosed(  WindowEvent  event ){ 
setVisible(  false ); 

System.exit(  0 ); 

} 

public  void  windowClosing(  WindowEvent  event )  { 
setVisible(  false ); 

System.exit(  0 ); 

} 

public  void  window Iconified(  WindowEvent  event )  { 

} 

public  void  windowDeiconified(  WindowEvent  event )  { 

} 
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public  void  window Activated(  WindowEvent  event )  { 

} 

public  void  windowDeactivated(  WindowEvent  event )  { 

} 

}); 

dialogClient  =  client; 
dialogTextEield  =  new  Eabel( 
setBackground(  BACKGROUND_COEOR ); 
setSize(  240,  300 ); 

setEayout(  new  BorderEayout() ); 

dialogTextEield.setBackground(  BACKGROUND_COEOR ); 
add(  dialogTextEield,  BorderEayout.NORTH ); 

imageCanvas  =  new  PETPCanvas(); 

imageCanvas.setBackground(  BACKGROUND_COEOR ); 

byte[]  imageBytes  =  new  byte[l]; 
try{ 

Pile  file  =  new  Pile(  "pftpEogoClient.gif" ); 

PileInputStream  fis  =  new  PileInputStream(  file  ); 
imageBytes  =  new  byte[(  int )  file.length()]; 
fis.read(  imageBytes  ); 

}  catch(  lOException  ioe  )  { 

System.out.println(  "No  logo  to  show!" ); 

} 

Image  image; 

image  =  Toolkit.getDefaultToolkit().createImage(  imageBytes  ); 
imageCanvas. setlmage(  image ); 

add(  imageCanvas,  BorderPayout.CENTER ); 

//  constructs  the  use  it  button 
useltButton  =  new  Button(  "Use  it!" ); 
useItButton.setPont(  new  Pont(  "Serif",  Pont.BOED,  20  ) ); 
useltButton. setPoreground(  PONT_COEOR ); 

useItButton.setBackground(  BACKGROUND_COEOR ); 
useltButton. addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
setVisible(  false ); 

}  //end  aetionPerformedO  method 
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}  //end  ActionListener  class 
);  //end  addActionListener()  method 

add(  useltButton,  BorderLay out. SOUTH  ); 

show(); 

}  //end  constructor 
}  //end  FrontDialog  class 

*  A  file  selction  dialog 
*/ 

private  class  FileSelectionDialog  extends  Dialog! 

/**  The  dialog  client  */ 

private  PFTPClientPPC  dialogClient; 

/**  The  dialog  control  panel  */ 
private  ControlPanel  dialogControlPanel; 

/**  The  dialog  text  field  */ 
private  Label  dialogTextField; 

/**  The  item  list  */ 
private  String!]  itemList; 

/**  The  dialog  combo  box  */ 
private  java.awt.List  dialogComboBox; 

/**  dialog  button  */ 
private  Button  dialogButton; 

/**  The  dialog  selection  */ 
private  String  dialogSelection; 

*  Constructor 

* 

*  @param  client  the  PFTPClientPPC  object  assosiated  with 

*  @param  panel  the  ControlPanel  object  assosiated  with 

*  @param  filcField  the  text  field 

*  @param  list  the  file  list 
*1 

public  FileSelectionDialog!  PFTPClientPPC  client, 
ControlPanel  panel, 
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Label  fileField, 

String[]  list 

){ 

super(  client,  "Choose  a  file  to  transfer",  true  ); 

addWindowListener(  new  WindowListener(){ 
public  void  windowOpened(  WindowEvent  event )  { 

} 

public  void  windowClosed(  WindowEvent  event ){ 
setVisible(  false ); 

} 

public  void  windowClosing(  WindowEvent  event ){ 
setVisible(  false ); 

} 

public  void  window Iconified(  WindowEvent  event )  { 

} 

public  void  windowDeiconified(  WindowEvent  event ){ 

} 

public  void  window Activated(  WindowEvent  event )  { 

} 

public  void  windowDeactivated(  WindowEvent  event )  { 

} 

}); 

dialogClient  =  client; 
dialogControlPanel  =  panel; 
dialogTextEield  =  fileEield; 
itemList  =  list; 
dialogSelection  =  null; 

setBackground(  BACKGROUND_COEOR ); 
setSize(  240,  200 ); 
this.setEocation(  0,  20 ); 
setEayout(  new  GridEayout(  5,  1 ) ); 

//  just  to  fill  the  empty  cell 
add(  new  Panel() ); 

dialogComboBox  =  new  java.awt.Eist(  4,  false  ); 
for(  int  k  =  0;  k  <  itemEist.length;  k++  ){ 
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dialogComboBox.add(  itemList[k]  ); 

} 

dialogComboBox.setFont(  new  Font(  "Serif",  Font.BOLD, 
PANEL_LABEL_FONT_SIZE ) ); 
dialogComboBox.setBackground(  BACKGROUND_COEOR ); 
dialogComboBox.setEoreground(  EONT_COEOR ); 
dialogComboBox.setEnabled(  true ); 
dialogComboBox.addItemEistener( 

//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemListenerO  { 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event.getStateChangeO  ==  ItemEvent.SEEECTED  ){ 
dialogSelection  =  itemEist[dialogComboBox. 
getSelectedIndexO] ; 

} 


} 

}  //  end  anonymous  inner  class 

);  //  end  call  to  addItemEistener 

add(  dialogComboBox ); 

add(  new  Panel() ); 

Panel  buttonPanel  =  new  Panel(); 
buttonPanel.setEayout(  new  GridEayout(  1,3)); 

//  constructs  the  ok  button 
dialogButton  =  new  Button(  "OK" ); 

dialogButton.setPont(  new  Pont(  "Serif", 

PANEE_EABEE_PONT_SIZE ) ); 

dialogButton.setPoreground(  PONT_COEOR ); 

dialogButton. setBackground(  BACKGROUND_COEOR ); 
dialogButton. addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
dialogTextEield.setText(  dialogSelection ); 
dialogControlPanel.setEileSelected(  true ); 
setVisible(  false ); 

}  //end  actionPerformedO  method 


Eont.BOED, 


146 


}  //end  ActionListener  class 
);  //end  addActionListener()  method 

buttonPanel.add(  new  Panel() ); 

buttonPanel.add(  dialogButton ); 

buttonPanel.add(  new  Panel() ); 

add(  buttonPanel ); 

add(  new  Panel() ); 

show(); 

}  //end  constructor 
}  //end  FIleSelectionDialog  class 

*  A  Message  dialog 
*f 

public  class  MessageDialog  extends  Dialog! 

/**  The  dialog  client  */ 

private  PFTPClientPPC  dialogClient; 

/**  The  dialog  title  */ 
private  String  dialogTitle; 

/**  The  dialog  text  field  */ 
private  Label  dialogTextField; 

/**  The  dialog  button  */ 
private  Button  dialogButton; 

/**  The  message  type  */ 
private  int  messageType; 

/**  The  dialog  message  */ 
private  String  dialogMessage; 

*  Constructor 

* 

*  @param  client  the  PFTPClientPPC  object  assosiated  with 

*  @param  panel  the  ControlPanel  object  assosiated  with 
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*  @param  title  the  dialog  title 

*  @param  type  the  dialog  type 

*  @param  message  the  dialog  message 
*1 

public  MessageDialog(  PFTPClientPPC  client, 

ControlPanel  panel, 

String  title, 
int  type. 

String  message 

){ 

super(  client,  title,  true  ); 

dialogClient  =  client; 

messageType  =  type; 

dialogMessage  =  message; 

dialogTextField  =  new  Label(  dialogMessage  ); 

dialogTextField.setFont(  new  Font(  "Serif",  Font.BOLD,  13  ) ); 

dialogTextField.  setForeground(  FONT_COLOR ); 

setBackground(  BACKGROUND_COLOR ); 

setSize(  240,  120 ); 

setLocation(  0,  80 ); 

setLayout(  new  GridLayout(  3,  1 ) ); 

addWindowListener(  new  Window Listener(){ 
public  void  windowOpened(  WindowEvent  event )  { 

} 

public  void  windowClosed(  WindowEvent  event ){ 
setVisible(  false ); 

} 

public  void  windowClosing(  WindowEvent  event )  { 
setVisible(  false ); 

} 

public  void  window Iconified(  WindowEvent  event )  { 

} 

public  void  windowDeiconified(  WindowEvent  event ){ 

} 

public  void  window Activated(  WindowEvent  event )  { 

} 

public  void  windowDeactivated(  WindowEvent  event )  { 

} 
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}); 

add(  dialogTextField ); 
add(  new  Panel() ); 

Panel  buttonPanel  =  new  Panel(); 

buttonPanel.setBackground(  BACKGROUND_COLOR ); 
if(  messageType  ==  MESSAGE_DIALOG_TYPE  ){ 
buttonPanel. setEayout(  new  GridEayout(  1,  1  ) ); 

buttonPanel. add(  new  Panel() ); 

//  constructs  the  ok  button 
dialogButton  =  new  Button(  "OK" ); 
dialogButton.setPont(  new  Pont(  "Serif",  Eont.BOED, 
PANEE_EABEE_PONT_SIZE ) ); 
dialogButton. setPoreground(  PONT_COEOR ); 

dialogButton. setBackground(  BACKGROUND_COEOR ); 
dialogButton. addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
setVisible(  false ); 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 

buttonPanel. add(  dialogButton ); 

buttonPanel. add(  new  Panel() ); 

}  else  if(  messageType  ==  YES_NO_DIAEOG_TYPE  ){ 
buttonPanel. setEayout(  new  GridEayout(  1,4)); 

buttonPanel. add(  new  Panel() ); 

//  constructs  the  yes  button 

Button  yesButton  =  new  Button(  "YES" ); 

yesButton.setEont(  new  Eont(  "Serif",  Eont.BOED,  PANEE_EABEE_EONT_SIZE  ) 

yesButton. setEoreground(  EONT_COEOR ); 

yesButton.setBackground(  BACKGROUND_COEOR ); 
yesButton. addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
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dialogClient.cancelFileTransferO; 
imageProgressPanel.setVisible(  false ); 
resetApplicationO ; 
setVisible(  false ); 

}  //end  actionPerformedO  method 
}  //end  ActionListener  class 
);  //end  addActionListener()  method 
buttonPanel.add(  yesButton ); 

//  constructs  the  no  button 

Button  noButton  =  new  Button(  "NO" ); 

noButton.setFont(  new  Font(  "Serif",  Font.BOLD,  PANEL_LABEL_FONT_SIZE  ) 

); 

noButton.setEoreground(  EONT_COEOR ); 

noButton. setBackground(  BACKGROUND_COEOR ); 
noButton. addActionEistener(  new  ActionEistener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
setVisible(  false ); 

}  //end  actionPerformedO  method 
}  //end  ActionEistener  class 
);  //end  addActionEistener()  method 
buttonPanel.add(  noButton ); 

buttonPanel.add(  new  Panel() ); 

}  else{ 

}  //end  if  else  if 
add(  buttonPanel ); 
show(); 

}  //end  constructor 
}  //end  MessageDialog  class 
}  //end  PETPClientPPC  class 
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//packages  for  network  componets 
import  java.io.*; 
importjava.net.*; 

//packages  for  user  interface  components 

import  java. awt.*; 

import  java. awt. event.*; 

import  java.util.*; 

import  javax. swing.*; 

import  javax. swing. text.*; 

//package  for  security  components 
import  j  ava.  security .  * ; 

//package  for  charecter  encoding  components 
import  sun.misc.*; 

*  File  PFTPServer.java 

* 

*  This  is  the  PFTP  Application  Server 

* 

*  This  server  is  waiting  for  clients  to  connect  on  port  and  it  supports 

*  only  file  tranfer  commands  sit  gets  a  file  transfer  command,  it  checks  if  the  file 

*  version  exists  looking  at  its  hash  valuesends  a  message 

*  about  how  many  bytes  is  the  file  and  then  send  them  one  byte  at  the 

*  time.  To  make  the  file  look  big,  I  placed  a  pause()  during  the  each 

*  byte  transfer. 

*  To  manage  the  lost  connection  and  keep  track  of  the  file  tranfer 

*  progress  each  of  them,  I  used  a  data  stucture  to  store  them 

* 

*  ©author  LT  Peri k1  is  Pantoleon 

*  ©version  1.0 
*/ 

public  class  PFTPServer  extends  JFrame{ 

// 

// 

//  Private  Data  Members: 

// 

// 

/**  The  default  port  the  FTP  server  is  waiting  for  clients  */ 
private  static  final  int  DEFAULT_PORT  =  6789; 
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/**  The  timeout  period  for  the  sockets  */ 
private  static  final  int  SO_TIME_OUT  =  3000; 

/**  The  length  in  bytes  of  the  file  hash  value  */ 
private  static  final  int  MD5_HASH_LENGTH  =  16; 

/**  The  key  for  the  hashing  computation*/ 

private  static  final  byte[]  HASH_KEY  =  (  new  String(  "Periklis" )  ).getBytes(); 

/**  The  font  size  for  the  panels'  titles  */ 

private  static  final  int  PANEE_TITEE_EONT_SIZE  =  17; 

/**  The  font  size  for  the  panels'  labels  */ 

private  static  final  int  PANEE_EABEE_PONT_SIZE  =13; 

/**  The  option  to  add  a  file  to  file  database  */ 
private  static  final  int  ADD_PIEE_OPTION  =  1 ; 

/**  The  option  to  remove  a  file  to  file  database  */ 
private  static  final  int  REMOVE_PIEE_OPTION  =  2; 

/**  The  request  type  when  a  file  is  asked  */ 
private  static  final  int  PIEE_REQUEST_TYPE  =  1 ; 

/**  The  request  type  when  a  file  array  is  asked  */ 

private  static  final  int  PIEE_ARRAY_REQUEST_TYPE  =  0; 

/**  The  panels'  font  color  */ 

private  static  final  Color  PONT_COEOR  =  Color. white; 

/**  The  color  of  the  backgroung  of  the  frames  and  panels  */ 

private  static  final  Color  BACKGROUND_COEOR  =  new  Color(  77,  92 , 240  ); 

/**  The  color  of  the  panels'  border  */ 

private  static  final  Color  PANEE_BORDER_COEOR  =  Color.blue; 

/**  The  file  name  of  the  logo  image  of  the  server  frame  */ 
private  static  final  String  EOGO_IMAGE  =  "pftpEogoServer.gif"; 

/**  The  server  socket  */ 
private  ServerSocket  serverSocket; 

/**  The  socket  that  is  assigned  to  the  client  */ 
private  Socket  mainSocket; 

/**  The  file  input  stream  */ 
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private  FileInputStream  fis; 


/**  The  map  that  store  the  file  available  for  transfer  */ 
private  AvailableFileMap  fileMap; 

/**  The  list  of  file  names  in  the  file  map  */ 
private  ArrayList  fileNamesInMap; 

/**  The  boolean  value  that  indicates  the  listening  status  of  the  server  */ 
private  boolean  startListening; 

/**  The  boolean  value  that  indicates  if  user  want  to  exit  the  application  */ 
private  boolean  exitApplication; 

/**  The  number  of  current  server  clients  */ 
private  int  numberOfCurrentClients; 

/**  The  number  of  total  file  transfers  tries  */ 
private  int  numberOfTotalTransfers; 

/**  The  number  of  failed  file  transfers  */ 
private  int  numberOfTransferFailures; 

/**  The  percentage  of  failed  file  transfers  */ 
private  double  percentageOfTransferFailures; 

/**  The  number  of  files  in  the  server  file  database  */ 
private  int  numberOfLocalFiles; 

// 

// 

//  Private  Data  Members  for  the  User  Interface: 

// 

// 

/**  The  panel  that  shows  the  server  status  */ 
private  PFTPServerStatusPanel  statusPanel; 

/**  The  front  label  shown  before  starting  the  server  */ 
private  JLabel  startFrontLabel; 

/**  The  menu  item  to  start  the  server  */ 
private  JMenuItem  startServerltem; 

/**  The  menu  item  to  stop  the  server  */ 
private  JMenuItem  stopServerltem; 
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/**  The  menu  item  to  add  a  file  to  server's  database  */ 
private  JMenuItem  addFileltem; 

/**  The  menu  item  to  remove  a  file  from  server's  database  */ 
private  JMenuItem  removeFileltem; 

/**  The  frame  used  to  delete  a  file  from  server's  database  */ 
private  JFrame  deleteFileFrame; 

// 

// 

//  Constructor: 

// 

// 

*  Default  constructor 
*1 

public  PFTPServerO  { 
super(  "PFTPServer" ); 

statusPanel  =  new  PFTPServerStatusPanel(  this ); 

fileMap  =  new  AvailableFileMapO; 

//  set  up  Server  menu  and  its  menu  items 
JMenu  fileMenu  =  new  JMenu(  "Server"  ); 
fileMenu.setMnemonic(  'S' ); 

//  set  up  start  server  item 

startServerltem  =  new  JMenuItem(  "Start  server" ); 

startServerItem.addActionListener( 

//  anonymous  inner  class  to  handle  menu  item  event 
new  ActionListenerO  { 

public  void  actionPerformed(  ActionEvent  event )  { 

if(  fileMap. isEmptyO  ){ 
JOptionPane.showMessageDialog(  null, 

"You  must  add  files  to  server  database  \n"  + 

"  before  you  start  the  server! !", 
"Can't  start", 
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JOptionPane.INFORMATION_MESSAGE); 


}  else{ 
try{ 

//  Creates  a  server  socket  with  the  defaut  port 
serverSocket  =  new  ServerSocket(  DEEAUET_PORT  ); 
startServerItem.setEnabled(  false ); 
stopServerItem.setEnabled(  true ); 
startEistening  =  true; 
startErontEabel.setVisible(  false ); 
statusPanel.setVisible(  true ); 

getContentPane().add(  statusPanel,  BorderEayout.CENTER ); 
}  catch(  lOException  ioe  )  { 

JOptionPane.showMessageDialog(  null,  ioe, 

"Problem  starting  the  server", 
JOptionPane.ERROR_MESSAGE ); 

}  //end  try  catch  block 
}  //end  if  else 

}  //end  actionPerformedO  method 
}  //  end  anonymous  inner  class 
);  //  end  call  to  addActiouEistener 
fileMenu.add(  startServerltem ); 

//  set  up  stop  server  item 

stopServerltem  =  new  JMenuItem(  "Stop  server" ); 
stopServerItem.setEnabled(  false ); 
stopServerItem.addActionEistener( 

//  anonymous  inner  class  to  handle  menu  item  event 
new  ActionEistenerO  { 

public  void  actionPerformed(  ActionEvent  event )  { 

stopServerItem.setEnabled(  false ); 
startServerltem.setEnabled(true) ; 
startEistening  =  false; 
startErontEabel.setVisible(  true ); 
statusPanel.  setVisible(  false ); 
try{ 

System.out.println("Server  stopped! "); 
serverSocket. closeO ; 

} catch  (lOException  ioe){ 

JOptionPane.showMessageDialog(  null,  ioe. 
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"Server  can  not  stop,  you  can  exit ", 
JOptionPane.ERROR_MESSAGE ); 


}//end  try  catch  block 


}  //end  actionPerformedO  method 
}  //  end  anonymous  inner  class 
);  //  end  call  to  addActiouEistener 
fileMenu.add(  stopServerltem ); 

//  set  up  Exit  menu  item 

JMenuItem  exititem  =  new  JMenuItem(  "Exit" ); 

exitItem.addActionEistener( 

//  anonymous  inner  class  to  handle  exititem  event 
new  ActionEistenerO  { 

//  terminate  application  if  user  select  the  exit  item 
public  void  actionPerformed(  ActionEvent  event )  { 

if(  JOptionPane.showConfirmDialog(  null, 

"Are  you  sure  you  want  to  exit  the  application?", 
null, 

JOptionPane.YES_NO_OPTION )  == 
JOptionPane.OK_OPTION ){ 

JOptionPane.showMessageDialog(  null,  "Thank  you  for  using  PETPServer", 
"PETPServer", 

JOptionPane.INPORMATION_MESSAGE); 

exitApplication  =  true; 

System.exit(  0 ); 

}  //end  if 

}  //end  actionPerformedO  method 
}  //  end  anonymous  inner  class 
);  //  end  addActiouEistener 
fileMenu.add(  exititem ); 

//  create  menu  bar  and  attach  it  to  the  server's  frame 
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JMenuBar  bar  =  new  JMenuBar(); 
setJMenuBar(  bar ); 

bar.add(  fileMenu ); 

//  set  up  Database  menu  and  its  menu  items 
JMenu  databaseMenu  =  new  JMenu(  "Database" ); 
fileMenu. setMnemonic(  'D' ); 

//  set  up  add  file  menu  item 

addFileltem  =  new  JMenuItem(  "Add  file  to  database" ); 

addFileItem.addActionListener( 

//  anonymous  inner  class  to  handle  menu  item  event 
new  ActionListenerO  { 

//check  if  the  file  extension  is  a  valid  one  and  add 

//the  file  to  server's  database 

public  void  actionPerformed(  ActionEvent  event )  { 

File  file  =  selectFile(  ADD_FILE_OPTION  ); 
if(  file.equals(  null ) ){ 

JOptionPane.showMessageDialog(  null,  "No  file  added", 

"PETPServer", 

JOptionPane.INPORMATION_MESSAGE); 

}  else  if(  !file.getName().endsWith(  ".gif" )  && 

!file.getName().endsWith(  ".GIE" )  && 

!file.getName().endsWith(  ".png" )  && 

!file.getName().endsWith(  ".PNG" )  && 

!file.getName().endsWith(  ".jpeg" )  && 

!file.getName().endsWith(  ".jpeg" ) ){ 

JOptionPane.showMessageDialog(  null,  "No  file  added  \n"  + 

"Please  select  only  .gif,  .png  or  .jpeg  files", 

"PETPServer", 

JOptionPane.INPORMATION_MESSAGE); 

}  else  { 

boolean  fileExists  =  fileMap.hasEile(file.getName()); 
int  userOption  =  JOptionPane.YES_OPTION; 
if  (fileExists)  { 

userOption  =  JOptionPane.showOptionDialog(null,  "  The  file  already  exists !.\n"+ 
"Do  you  want  to  overwrite  it?",  "Eile  exists!",  JOptionPane.YES_NO_OPTION, 
JOptionPane.INEORMATION_MESSAGE,  null,  null,  null); 

}else{ 
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//numberOfLocalFiles++ ; 

}//end  if 

if  (userOption  ==  JOptionPane.YES_OPTION){ 
try{ 

FileInputStream  fis  =  new  FileInputStream(  file  ); 
byte[]  fileBytes  =  new  byte[(  int )  file.length()]; 

//read  the  bytes  from  the  file 
fis.read(  fileBytes  ); 
if  (fileExists)  { 

fileMap  .removeFile(file  .getN  ame() ) ; 
fileNamesInMap.remove(file.getName()); 

} 

fileMap. addFile(  file.getName(),  fileBytes  ); 
fileNamesInMap.add(  file.getName() ); 
fis.closeO; 

numberOfFocalFiles++ ; 

}  catch(  lOException  ioe  )  { 

JOptionPane.showMessageDialog(  null,  "No  file  added  \n"  + 
"Problem  reading  the  file!", 

"Error", 

JOptionPane.ERROR_MESSAGE ); 

}  //end  try  catch  block 
}//end  if 

}  //end  if  else  if  block 
statusPanel.updateServerStatusO; 

}  //end  actionPerformedO  method 
}  //  end  anonymous  inner  class 

);  //  end  call  to  addActionEistener 

databaseMenu.add(  addFileltem ); 

//  set  up  remove  file  menu  item 

removeFileltem  =  new  JMenuItem(  "Remove  a  file  from  database" ); 

removeFileItem.addActionEistener( 

//  anonymous  inner  class  to  handle  menu  item  event 
new  ActionEistenerO  { 

//  if  the  file  database  is  not  empty  it  removes  the  file  selected 
public  void  actionPerformed(  ActionEvent  event )  { 
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if(  fileMap.isEmptyO  ){ 

JOptionPane.showMessageDialog(  null,  "No  file  available  in  database", 
"PFTPServer", 

JOptionPane.INFORMATION_MESSAGE); 


}  else{ 

String[]  fileEist  =  new  String[fileNamesInMap.size()  +  1]; 
for(  int  i  =  0;  i  <  fileEist.length;  i++  ){ 
if(i==0){ 

fileEist[i]  =  "Select  file  to  delete"; 

}  else{ 

fileEist[i]  =  (  String  )  fileNamesInMap.get(  i  -  1  ); 

}  //end  if  else 
}  //end  for  loop 

deleteFileFrame  =  new  DeleteFileFrame(  fileEist ); 

}  //end  if  else 

statusPanel.updateServerStatusO; 

}  //end  actionPerformedO  method 

}  //  end  anonymous  inner  class 
);  //  end  call  to  addActionEistener 

//  create  a  menu  item  and  attach  it  to  menu  bar 
databaseMenu.add(  removeFileltem ); 
bar.add(  databaseMenu ); 

//create  the  front  label  of  the  main  frame 

startFrontEabel  =  new  JEabel(  new  ImageIcon(  EOGO_IMAGE  ) ); 
getContentPane().setBackground(  BACKGROUND_COEOR ); 
getContentPane().add(  startFrontEabel,  BorderEayout.CENTER ); 

setSize(  350,  200 ); 

setEocation(  300,  250 ); 
setVisible(  true ); 

setDefaultCloseOperation(  JFrame.EXIT_ON_CEOSE ); 

//intialize  the  main  variables 
startEistening  =  false; 
exitApplication  =  false; 
fileMap  =  new  AvailableFileMapO; 
fileNamesInMap  =  new  Array Eist(); 
numberOfCurrentClients  =  0; 
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numberOfTotalTransfers  =  0; 
numberOfTransferFailures  =  0; 
percentageOfTransferFailures  =  0; 
numberOfLocalFiles  =  0; 

//update  the  server  status 
statusPanel.updateServerStatusO; 

}  //  end  default  constructor 

*  Sets  the  number  of  current  clients 

* 

*  @param  currentClients  number  of  current  clients 
*1 

public  void  setNumberOfCurrentClients(  int  currentClients  )  { 
numberOfCurrentClients  =  currentClients; 

}  //end  setNumberOfCurrentClientsO  method 

/** 

*  Sets  the  number  of  total  file  transfers 

* 

*  @param  totalTransfers  the  number  of  total  file  transfers 
*1 

public  void  setNumberOfrotalTransfers(  int  totalTransfers  ){ 
numberOfTotalTransfers  =  totalTransfers; 

}  //end  setNumberOfTotalTransfersO  method 

*  Sets  the  number  of  failed  file  transfers 

* 

*  @param  totalFailures  the  number  of  failed  file  transfers 
*1 

public  void  setNumberOfTransferFailures(  int  totalFailures ){ 
numberOfTransferFailures  =  totalFailures; 

}  //end  setNumberOfTransferFailuresO  method 

*  Sets  the  percentage  of  failed  transfers 

* 

*  @param  failurePercentage  the  percentage  of  failed  transfers 
*1 

public  void  setPercentageOfTransferFailures(  double  failurePercentage  ){ 
percentageOfTransferFailures  =  failurePercentage; 

}  //end  setPacketSizeO  method 
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/=H* 

*  Sets  the  number  of  local  files  in  server's  database 

* 

*  @param  localFiles  the  number  of  local  files  in  server's  database 
*/ 

public  void  setNumberOfLocalFiles(  int  localFiles  ){ 
numberOfLocalFiles  =  localFiles; 

}  //end  setNumberOfLocalFilesO  method 

*  Returns  the  number  of  current  clients 

* 

*  ©return  the  number  of  current  clients 
*1 

public  synchronized  int  getNumberOfCurrentClients()  { 
notify  0; 

return  numberOfCurrentClients; 

}  //end  getNumberOfCurrentClientsO  method 

/** 

*  Returns  the  number  of  total  file  transfers 

* 

*  ©return  the  number  of  total  file  transfers 
*1 

public  synchronized  int  getNumberOfTotalTransfers()  { 
notifyO; 

return  numberOfTotalTransfers; 

}  //end  getNumberOfTotalTransfersO  method 

*  Returns  the  number  of  failed  file  transfers 

* 

*  ©return  the  number  of  failed  file  transfers 
*1 

public  synchronized  int  getNumberOfTransferFailures(){ 
notifyO; 

return  numberOfTransferFailures; 

}  //end  getNumberOfTransferFailuresO  method 

/** 

*  Returns  the  percentage  of  failed  transfers 

* 

*  ©return  the  percentage  of  failed  transfers 
*1 

public  synchronized  double  getPercentageOfTransferFailures(){ 
notifyO; 
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if(  getNumberOfTotalTransfersO  !=  0  ){ 
setPercentageOfTransferF  ailures  ( 

(  double  )  (  getNumberOfTransferFailuresO  / 
getNumberOfTotalTransfersO  )  * 

100); 

}  else{ 

setPercentageOfrransferFailures(  0 ); 

}  //end  if  else 

return  percentageOfTransferFailures; 

}  //end  getPercentageOfTransferFailuresO  method 

*  Returns  the  number  of  local  files  in  server's  database 

* 

*  ©return  the  number  of  local  files  in  server's  database 
*1 

public  synchronized  int  getNumberOfLocalFiles()  { 
notify  0; 

return  numberOfLocalFiles; 

}  //end  getNumberOfLocalFilesO  method 

/** 

*  Adds  a  panel  to  a  container 

* 

*  @param  container  the  container  to  add  the  panel 
*1 

public  void  addPanel(  Container  container  )  { 

JPanel  dummy  =  new  JPanel(); 

dummy. setBackground(  BACKGROUND_COLOR ); 

container.  add(  dummy ); 

}  //end  addPanelO  method 

*  Removes  a  file  from  server's  database 

* 

*  @param  fileForDeletion  the  string  file  name  to  delete  from  database 
*1 

public  void  removeFromDatabase(  String  fileForDeletion  )  { 
if(  !fileForDeletion.equals(  null ) ){ 
fileMap.removeFile(  fileForDeletion ); 
fileNamesInMap.remove(  fileForDeletion ); 
numberOfLocalFiles—; 

J OptionPane .  showMess ageDialog(  null, 

"File  "  +  fileForDeletion  +  "  deleted!", 
"PFTPServer", 

JOptionPane.INFORMATION_MESSAGE); 
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}  else{ 

JOptionPane.showMessageDialog(  null,  "No  file  deleted!", 
"PFTPServer", 

JOptionPane.INFORMATION_MESSAGE); 

}  //end  if  else 

}  //end  removeEromDatabaseO  method 

*  Returns  the  file  that  selected  by  the  user  to  be  added  or  removed 

* 

*  ©return  the  file  that  selected  by  the  user  to  be  added  or  removed 

*  @param  addOrRemoveOption  the  integer  option  for  add  or  remove 
*1 

private  Eile  selectEile(  int  addOrRemoveOption  ){ 

Eile  selectedEileName  =  null; 
try{ 

//  display  file  dialog  so  user  can  select  file 
JEileChooser  fileChooser  =  new  JEileChooser(); 
fileChooser.setEileSelectionMode( 

JEileChooser.EIEES_ONEY ); 

int  result; 

if(  addOrRemoveOption  ==  ADD_EIEE_OPTION  )  { 
result  =  fileChooser. showDialog(  this,  "Add" ); 

}  else{ 

result  =  fileChooser. showDialog(  this,  "Remove" ); 

} 

//  if  user  clicked  Cancel  button  on  dialog,  return 
if(  result  ==  JEileChooser. CANCEE_OPTION  ){ 
return  null; 

}  else  if(  result  ==  JEileChooser. APPRO VE_OPTION  ){ 

//  obtain  selected  file 

selectedEileName  =  fileChooser. getSelectedEile(); 

}  //end  if  else  if 

}  catch(  NullPointerException  npe  )  { 

}  //end  try  catch  block 
return  selectedEileName; 

}  //  end  selectEileO  method 
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*  Delays  the  current  thread  by  certain  amount  of  milliseconds 

* 

*  @param  msec  the  milliseconds  to  delay  the  execution 
*1 

public  void  delay(  int  msec  )  { 
try{ 

Thread.  sleep(  msec  ); 

}  catch(  InterruptedException  ie  )  { 

System.out.println(  "Thead  sleep  interupted" ); 

}  //  end  try  catch  block 
}  //  end  delayO  method 

/** 

*  Manage  the  starting  and  sloping  of  the  server  side 
*t 

public  void  startListeningO  { 
while(  lexitApplication ){ 
delay(  50 ); 

if(  startListening )  { 

System.out.println(  "Server  started!" ); 
try{ 

while(  startListening )  { 
mainSocket  =  serverSocket.accept(); 

ClientHandler  newClientHandler  =  new  ClientHandler(  mainSocket ); 
System.out.println(  "New  connection  established" ); 
statusPanel .  updateServerS  talus  () ; 

Thread  newConnection  =  new  Thread(  newClientHandler  ); 
newConnection.startO; 
if(  !  startListening ){ 
startServerItem.setEnabled(  true ); 

} 

}  //end  while  loop 


}  catch(  lOException  ioe  )  { 
if(  startListening )  { 

JOptionPane.showMessageDialog(  null,  ioe, 

"Server  can  not  start  listening  "  + 

"in  port "  +  DEPAULT_PORT, 
JOptionPane.ERROR_MESSAGE ); 


}//end  if 

}  //end  try  catch  block 
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}  else  if  (serverSocket  !=  null  &&  !serverSocket.isClosed()){ 


}//  end  if  else 
}  //end  outer  whole  loop 
System.exit(  0 ); 

}  //end  startListening  method 

*  Main  method  to  start 

* 

*  @param  args  argument  list 

*  ©throws  Exception 
*/ 

public  static  void  main(  String  args[]  ){ 

//Initialiaze  the  server  application 
PFTPServer  theFTPServer  =  new  PFTPServer(); 
//start  listening  at  default  port 
theFTPServer .  startFisteningO ; 

}  //end  main  method 


// 

// 

//  Private  Inner  Classes: 

// 

// 

*  Handles  the  connection  and  the  file  transfer  with  each  client 
*1 

private  class  ClientHandler  implements  Runnable  { 

/**  The  socket  to  comunicate  with  the  client  */ 
private  Socket  clientSocket; 

/**  The  object  input  stream  to  receive  objects  from  client  */ 
private  ObjectInputStream  inObjectFromClient; 

/**  The  object  output  stream  to  send  objects  to  client  */ 
private  ObjectOutputStream  outObjectToClient; 

/**  The  file  request  received  from  client  */ 
private  PFTPFileRequest  request; 

/**  The  vector  of  the  files  available  in  the  server  database  */ 
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private  Vector  filesAvailable; 

/**  The  request  type  */ 
private  int  requestType; 

/**  The  requested  file  name  */ 
private  String  fileName; 

/**  The  hash  value  of  the  requested  file  */ 
private  String  fileHash; 

/**  The  packet  size  */ 
private  int  packetSize; 

/**  The  offset  value  in  the  file  request  */ 
private  int  offset; 

/**  The  length  of  the  requested  file  in  bytes  */ 
private  int  numOfBytes; 

*  Constructor 

* 

*  @param  aSocket  the  socket  to  communicate  with  the  client 

*  ©throws  SocketException 
*1 

public  ClientHandler(  Socket  aSocket )  throws  SocketException  { 

//  Initialize  the  socket  to  client 
clientSocket  =  aSocket; 

//  Sets  the  timout  period  of  the  socket 
clientSocket.setSoTimeout(SO_TIME_OUT); 

}  //end  constructor 

/** 

*  The  run()  method  of  the  Runnable  ClientHandler  class  that 

*  handles  the  connection  to  the  client 
*/ 

public  void  run()  { 

setNumberOfCurrentClients(  getNumberOfCurrentClients()  +  1  ); 
System.out.println("Clients:  "  +  getNumberOfCurrentClients() ); 
statusPanel.updateServerStatusO; 

//  Opens  the  streams  for  communicating  with  the  client 
openStreamsO; 

//  Handles  the  file  transfer 
handleEileRequestO ; 
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//  Closes  the  connection  when  done 
closeConnectionO ; 

//  Reduce  the  number  of  clients  connected 
setNumberOfCurrentClients(  getNumberOfCurrentClients()  -  1 ); 
System.out.println("Clients:  "  +  getNumberOfCurrentClients() ); 
statusPanel.updateServerStatusO; 

}  //  end  of  run()  method 

*  Opens  the  streams  for  communicating  with  the  client 
*1 

private  void  openStreams()  { 
try{ 

outObjectToClient  =  new  ObjectOutputStream( 
clientSocket.getOutputStreamO  ) ; 

inObjectFromClient  =  new  ObjectInputStream( 
clientSocket.getInputStreamO  ); 

}  catch(  lOException  ioe  )  { 

System.out.println(  "Server:  Failed  to  open  FO  streamsVn"  +  ioe  ) 
System.exit(  1  ); 

}  //  end  try  catch  block 
}  //  end  openStreamsO  method 

/** 

*  Handles  the  file  request  of  the  client 
*/ 

private  void  handleFileRequest()  { 
try{ 

System.out.println(  "New  client  connected!!" ); 

request  =  (  PFTPFileRequest )  inObjectFromClient.readObject(); 

requestType  =  request.getRequestType(); 

if(  requestType  ==  FILE_ARRAY_REQUEST_TYPE  ){ 
files  Available  =  new  Vector(); 
for(  int  k  =  0;  k  <  fileNamesInMap.size();  k++  ){ 
files  Available. add(  fileNamesInMap.get(  k ) ); 

}  //end  for  loop 
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outObjectToClient.writeObject(  files  Available ); 
outObjectToClient.flushO; 

}  else  if(  requestType  ==  FILE_REQUEST_TYPE  ){ 
clientSocket.setSoTimeout(  SO_TIME_OUT ); 
fileName  =  request. getEile(); 
fileHash  =  request.  getHash(); 
offset  =  request.  getOffsetO; 
packets  ize  =  request.getPacketSize(); 

System.out.println(  "Received  request  packet  ->  ...  Pile  name:  "  + 
fileName  + 

"\n  Pile  hash:  "  + 

fileHash  + 

"\n  Offset:  "  + 

offset  + 

"\n  Packet  size:  "  + 

packets  ize ); 

if(  offset  ==  0  ){ 

fileHash  =  getHashValue(  fileName  ); 
if(  fileHash.equals(  new  String(  "fileNotPound" ) ) ){ 
System.out.println(  "Pile  "  +  fileName  +  "  not  found!" ); 
outObjectToClient.writeUTP(  fileHash ); 
outObjectToClient.flushO; 

}  else  if(  fileHash.equals(  new  String(  "hashProblem" ) ) ){ 
System.out.println(  "Problem  in  hashing  file  "  +  fileName  ); 
outObjectToClient.writeUTP(  fileHash ); 
outObjectToClient.flushO; 

}  else{ 

System.out.println(  "Pile  found!" ); 

outObjectToClient.writeUTP(  fileHash ); 
outObjectToClient.flushO; 

System.out.println(  "Hash  "  +  fileHash  +  "  is  send,  length  "  + 
fileHash.lengthO  ); 

System.out.println(  "Sending  the  file...." ); 
sendPile(  fileName,  packetSize,  offset ); 

}  //end  if  else  if 
}  else{ 
try{ 

if(  checkHash(  fileName,  fileHash  ) ){ 

System.out.println(  "Sending  the  file...." ); 
outObjectToClient.writeUTP(  "Start  sending" ); 
sendPile(  fileName,  packetSize,  offset ); 

}  else{ 

outObjectToClient.writeUTP(  "fileNotMatch" ); 
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}  //end  if  else 

}  catch(  lOException  ioe  )  { 

System.out.println(  "Problem  in  sending  the  file!" ); 
setNumberOfTransferFailures(  getNumberOfTransferFailures()  +  1 ); 
statusPanel.updateServerStatusO; 

System.out.println(  ioe ); 

}  //  end  try  catch  block 
}  //  end  if  else  block 
}  else{ 

outObjectToClient.writeUTF(  "noValidRequest" ); 
outObjectToClient.flushO; 

}  //end  if  else  if 
}  catch(  Exception  e  )  { 

System.out.println(  e ); 

} 

}  //  end  HandleFileRequestO  method 

*  Closes  the  socket  connection 
*1 

private  void  closeConnection()  { 
try{ 

clientSocket.closeO; 

}  catch(  lOException  ioe  )  { 

}  //end  try  catch  block 
}  //end  closeConnectionO  method 

/** 

*  Compute  the  hash  value  of  a  given  file 

* 

*  @param  fileName  the  name  of  the  file 

*  ©return  the  String  representation  of  the  file  hash  value 
*/ 

public  String  getHashValue(  String  fileName  ){ 

String  theHash  =  null; 
try{ 

File  theFile  =  new  File(  fileName  ); 
fis  =  new  FileInputStream(  theFile  ); 
byte[]  buffer  =  new  byte[8192]; 
int  length; 

//Select  the  MD5  hash  algorithm 

MessageDigest  md  =  MessageDigest.getInstance(  "MD5" ); 
while/  ( length  =  fis.read/  buffer  ) )  !=  -1  ){ 
md.update/  buffer,  0,  length  ); 

} 
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fis.closeO;  //  Close  the  file  stream  to  free  the  file 

//  Final  computation  of  the  hash 
byte[]  hash  =  md.digest(); 

//  Create  a  String  version  of  the  hash  value  using  the  default 
//  64bit  Character  encoding  algorithm. 

BASE64Encoder  encoder  =  new  BASE64Encoder(); 
theHash  =  encoder. encode(  hash  ); 

}  catch(  EileNotEoundException  fnfe  ){  //In  case  file  not  found 
System.out.println(  fnfe ); 
theHash  =  new  String(  "fileNotEound" ); 

}  catch(  Exception  e  ){  //In  case  there  is  problem 
System.out.println(  e  );  //  with  hash  computation 
theHash  =  new  String(  "hashProblem" ); 

} 

return  theHash; 

}  //  end  getHashValueO  method 

*  Checks  if  a  file  is  asked  have  the  given  hash  value 

* 

*  @param  file  the  name  of  the  file 

*  @param  hashValueToCheck  the  hash  value  to  check  the  validity 

*  ©return  true  if  hashes  match  and  false  if  they  don't 
*/ 

public  boolean  checkHash(  String  file,  String  hashValueToCheck  ){ 
boolean  check; 

String  existedHash  =  getHashValue(  file  ); 

if(  existedHash.equals(  hashValueToCheck  ) ){ //check  the  two  hashes 
check  =  true; 

}  else{ 

check  =  false; 

}  //end  if  else 

return  check; 

}//end  checkHashO  method 

*  Sends  the  file  to  client  with  the  asked  packet  size  and  offset 

* 

*  @param  nameOfEile  the  name  of  the  file 
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*  @param  packets ize  the  hash  value  to  check  the  validity 

*  @param  offset  the  offset  from  where  client  wants  the  file 

*  ©throws  lOException  if  something  goes  wrong  with  the  stream  use 

*  ©throws  FileNotFoundException  if  the  file  asked  doesn't  exist 
*1 

public  void  sendFile(  String  nameOfFile,  int  packetSize,  int  offset )  throws 
lOException,  FileNotFoundException  { 

File  file  =  new  File(  nameOfFile  ); 

int  numOfBytes  =  ( int )  file.length(); 

int  numOfPackets  =  (  numOfBytes  /  packetSize  )  +  1 ; 

System.out.println(  nameOfFile ); 

//sending  the  file  total  number  of  bytes 
outObjectToClient.writeInt(  numOfBytes  ); 
outObjectToClient.flushO; 

System.out.println(  "File  size  sent "  +  numOfBytes  +  "  bytes" ); 

//  open  a  sream  to  the  file 

FileInputStream  inFile  =  new  FileInputStream(  nameOfFile  ); 
byte[]  fileInBytes  =  new  byte  [numOfBytes  +  packetSize]; 

//read  the  bytes  from  the  file 
inFile.read(  fileInBytes ); 

System.out.println(  "Client:  "  + 

( clientSocket.getInetAddressO  ).toString() 

+  "  from  port "  +  clientSocket.getPort() 

+  "  asked  for  file  "  +  nameOfFile 
+  "\nOffset:  "  +  offset ); 

int  currentPacket  =  offset; 

try] 

//send  the  packets 

setNumberOfTotalTransfers(  getNumberOfTotalTransfers()  +  1  ); 
while/  currentPacket  <  numOfPackets  )  { 
outObjectToClient. write/  fileInBytes,  currentPacket  *  packetSize, 
packetSize ); 

outObjectToClient.flush/); 

System.out.println/  "Bytes  "  +  currentPacket  *  packetSize  +  "  to  "  + 

/  currentPacket  +  1 )  *  packetSize  +  "  sent" ); 
delay/  500 ); 

currentPacket++; 

}  //end  while  loop 
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//check  if  the  transfer  ends 


if(  currentPacket  ==  numOfPackets  && 
inObjectFromClient.readBooleanO  )  { 

System.out.println(  "File  is  sent!" ); 

}  //end  if 

}  catch(  lOException  ioe  )  { 

System.out.println(  ioe ); 

setNumberOfTransferFailures(  getNumberOfTransferFailures()  +  1  ); 

}  //end  try  catch  block 
}  //  end  sendFileO  method 
}  //end  ClientHandler  inner  class 

*  A  panel  that  contains  useful  informations  about  the  server 

*  operation  status. 

*1 

private  class  PFTPServerStatusPanel  extends  JPanel{ 

/**  The  PFTP  server  that  has  this  panel  */ 
private  PFTPServer  serverStatusPanelServer; 

/**  The  title  of  the  status  panel  */ 
private  JTextPane  serverStatusPanelTitle; 

/**  The  textpane  that  shows  the  number  of  current  clients  */ 
private  JTextPane  numberOfCurrentClientsInfo; 

/**  The  textpane  that  shows  the  number  of  total  file  transfers  */ 
private  JTextPane  numberOfTotalTransfersInfo; 

/**  The  textpane  that  shows  the  number  of  failed  file  transfers  */ 
private  JTextPane  percentageOfTransferFailuresInfo; 

/**  The  textpane  that  shows  the  number  of  local  files  in  server's  database  */ 
private  JTextPane  numberOfLocalFilesInfo; 

/** 

*  Constructor 

* 

*  @param  server  the  PFTPServer  that  owns  the  panel 
*1 

public  PFTPServerStatusPanel(  PFTPServer  server  ){ 
superO; 
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serverStatusPanelServer  =  server; 


setBorder(  BorderFactory.createLineBorder(  PANEL_BORDER_COLOR  ) ); 

numberOfCurrentClientsInfo  =  getTitledPanel(  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
numberOfCurrentClientsInfo.setEoreground(  EONT_COEOR ); 

numberOfTotalTransfersInfo  =  getTitledPanel(  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
numberOfTotalTransfersInfo.setEoreground(  EONT_COEOR ); 

percentageOfTransferEailuresInfo  =  getTitledPanel( 

PANEE_EABEE_EONT_SIZE, 

EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
percentageOfTransferEailuresInfo.setEoreground(  EONT_COEOR ); 

numberOfEocalEilesInfo  =  getTitledPanel( 

PANEE_EABEE_EONT_SIZE, 

EONT_COEOR, 

BACKGROUND_COEOR,  false,  true ); 
numberOfEocalEilesInfo.setEoreground(  EONT_COEOR ); 

setBackground(  BACKGROUND_COEOR ); 
setEayout(  new  GridEayout(  5,  2  ) ); 

add(  getTitledPanel(  "SERVER  STATUS",  PANEE_TITEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  true,  true  ) ); 

add(  getTitledPanel( PANEE_EABEE_EONT_SIZE,  EONT_COEOR, 
BACKGROUND_COEOR,  false,  true  ) ); 

add(  getTitledPanel(  "Current  clients  :",  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
add(  numberOfCurrentClientsInfo ); 

add(  getTitledPanel(  "Total  file  transfers  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
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add(  numberOfTotalTransfersInfo ); 


add(  getTitledPanel(  "Transfer  failures  PANEL_LABEL_FONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 
add(  percentageOfTransferEailuresInfo ); 

add(  getTitledPanel(  "Elies  in  database  PANEE_EABEE_EONT_SIZE, 
EONT_COEOR, 

BACKGROUND_COEOR,  false,  true  ) ); 

add(  numberOfEocalEilesInfo ); 

setVisible(  false ); 
setEnabled(  false ); 


} 

*  Return  a  titled  JTextPanel  with  specific  attributes 

* 

*  @param  titleText  the  delay  time  in  milliseconds 

*  @param  charSize  the  character  size 

*  @param  charColor  the  character  color 

*  @param  backgroundColor  the  backgroundColor 

*  @param  isUnderlined  if  the  character  is  underlined  or  not 

*  @param  isBold  if  the  character  is  bold  or  not 

*  ©return  a  titled  JtextPanel  with  specific  attributes 
*1 

public  JTextPane  getTitledPanel(  String  titleText,  int  charSize, 
Color  charColor,  Color  backgroundColor, 
boolean  isUnderlined,  boolean  isBold )  { 
JTextPane  textPane; 

Defaults tyledDocument  doc  =  new  DefaultStyledDocument(); 
textPane  =  new  JTextPane(  doc  ); 

Mutable AttributeSet  attr  =  new  SimpleAttributeSet(); 
StyleConstants.setFontSize(  attr,  charSize ); 
StyleConstants.setUnderline(  attr,  isUnderlined ); 
StyleConstants.setForeground(  attr,  charColor ); 
StyleConstants.setBold(  attr,  isBold ); 
textPane. setEditable(  false ); 
textPane. setEnabled(  false ); 
textPane.setBackground(  backgroundColor ); 
textPane.setCharacterAttributes(  attr,  true ); 
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textPane.setText(  titleText ); 
return  textPane; 

}  //end  getTitledPanelO  method 

*  Updates  file  transfer's  status 
*/ 

public  synchronized  void  updateServerStatus(){ 
notify  0; 

numberOfCurrentClientsInfo.setText(  new  Integer( 

serverStatusPanelServer .getNumberOfCurrentClientsO  )  .toStringO  ) ; 
numberOfTotalTransfersInfo.setText(  new  Integer( 

serverStatusPanelServer.getNumberOfTotalTransfersO  ) .toStringO  ) ; 
percentageOfTransferFailuresInfo.setText(  new  Double( 

serverStatusPanelServer. getPercentageOfTransferFailuresO  )  .toStringO  + 

"%" ); 

numberOfLocalFilesInfo.setText(  new  Integer( 

serverStatusPanelServer.getNumberOfLocalFilesO  ). toStringO  ); 

}  //end  updateFileTransferStatusO  method 

*  Resets  the  panel 
*/ 

public  void  resetO  { 

S  wingUtilities  .invokeLater( 

new  UpdateTextPane(  numberOfCurrentClientsInfo, 

S  wingUtilities  .in vokeLater( 

new  UpdateTextPane(  numberOfTotalTransfersInfo, 

S  wingUtilities  .invokeLater( 

new  UpdateTextPane(  percentageOfTransferFailuresInfo, 

S  wingUtilities. invokeLater( 

new  UpdateTextPane(  numberOfLocalFilesInfo, 

}  //end  resetO  method 

*  Updates  a  TextPane 
*1 

public  class  UpdateTextPane  extends  Thread { 

/**  The  text  pane  to  update  */ 
private  JTextPane  textPane; 
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/**  The  the  text  to  set  to  the  text  pane  */ 
private  String  text; 

*  Constructor 

* 

*  @param  jTextPane  the  text  pane  to  update 

*  @param  aText  the  text  to  be  shown  on  the  text  pane 
*1 

public  UpdateTextPane(  JTextPane  jTextPane,  String  aText ){ 
textPane  =  JTextPane; 
text  =  aText; 

}  //end  constructor 

//  method  called  to  update  outputArea 
public  void  run(){ 
textPane.setText(  text ); 

}  //end  run()  method 

}  //  end  class  UpdateThread 


} 

*  Updates  a  TextPane 
*/ 

private  class  DeleteFileFrame  extends  JFrame{ 

/**  The  combo  box  with  files  to  select  */ 
private  JComboBox  filesToDelete; 

/**  The  string  array  with  file  names  available  to  delete  */ 
private  String[]  filcNames; 

/**  The  button  to  use  for  deleting  */ 
private  JButton  deleteButton; 

/**  The  file  name  selected  to  be  deleted  */ 
private  String  fileSelected; 

*  Constructor 

* 

*  @param  thcFileNames  the  frame's  string  array  with  files  names  to  delete 
*/ 
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public  DeleteFileFrame(  String[]  theFileNames  ){ 


super(  "Delete  file" ); 

//  get  content  pane  and  set  its  layout 
Container  container  =  getContentPane(); 
container. setLayout(  new  GridLayout(  4,  1  ) ); 

fileNames  =  theFileNames; 
fileSelected  =  null; 

addPanel(container) ; 

//  set  up  delete  file  JComboBox 
filesToDelete  =  new  JComboBox(  fileNames  ); 
filesToDelete.setBackground(  BACKGROUND_COLOR ); 
filesToDelete.setForeground(  FONT_COLOR ); 
filesToDelete. addItemListener( 

//  anonymous  inner  class  to  handle  JComboBox  events 
new  ItemListenerO  { 

//  handle  JComboBox  event 

public  void  itemStateChanged(  ItemEvent  event )  { 

//  determine  whether  check  box  selected 
if(  event. gets tateChangeO  ==  ItemEvent.  SELECTED  ) 
fileSelected  =  fileNames  [filesToDelete. getSelectedIndex()]; 
deleteButton.setEnabled(  true ); 

}//end  itemStateChangedO  method 

}  //  end  anonymous  inner  class 

);  //  end  call  to  addItemListener 

container. add(  filesToDelete ); 

addPanel(container) ; 

//  set  up  delete  button 

deleteButton  =  new  JButton(  "Delete  file" ); 
deleteButton.setEnabled(  false ); 

deleteButton.setBackground(  BACKGROUND_COLOR ); 
deleteButton. setEoreground(  EONT_COLOR ); 
deleteButton. addActionListener(  new  ActionListener()  { 
public  void  actionPerformed(  ActionEvent  event )  { 
removeEromDatabase(  fileSelected ); 
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setVisible(  false ); 

}  //end  actionPerformedO  method 
}  //end  ActionListener  class 
);  //end  addActionListener()  method 

container. add(  deleteButton ); 

setSize(  250,  200 ); 
setLocation(  340,  250 ); 
setResizable(  false ); 

setDefaultCloseOperation(  JFrame.HIDE_ON_CLOSE ); 
setVisible(  true ); 

}  //end  constructor 

}  //  end  class  DeleteEileErame 

}  //  end  PETPServer  class 
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//packages  for  transmiting  the  object  over 
//an  input  and  output  stream 
import  java.io. Serializable; 

*  File  PFTPFileRequest.java 

* 

*  Provides  an  object  to  hold  the  data  of  the  file  transfer  request 

* 

*  ©author  LT  Peri k1  is  Pantoleon 

*  ©version  1.0 
*1 

public  class  PFTPFileRequest 
implements  Serializable  { 

/**  The  type  of  the  file  request  */ 
private  int  requestType; 

/**  The  file  to  request  */ 
private  String  file; 

/**  The  hash  value  of  the  file  */ 
private  String  hash; 

/**  The  byte  offset  */ 
private  int  offset; 

/**  The  socket  to  comunicate  with  the  client  */ 
private  int  packetSize; 

/** 

*  Constructor 

* 

*  ©param  theRequestType  the  type  of  the  request  1  if  it  is  file  request  and 

*  0  if  it  is  available  files  request 

*  ©param  theFileName  the  file  name 

*  ©param  theFileHash  the  file  hash  value 

*  ©param  theFileOffset  the  file  offset 

*  ©param  thePacketSize  the  file  transfer  packet  size 
*/ 

public  PFTPFileRequest(int  theRequestType, 

String  theFileName, 

String  theFileHash, 
int  theFileOffset, 
int  thePacketSize)  { 
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this.requestType  =  theRequestType; 
this.file  =  theFileName; 
this. hash  =  theFileHash; 
this.offset  =  theFileOffset; 
this.packetSize  =  thePacketSize; 

}  //end  FileRequest  class  constructor 

*  Gets  the  request  type 

* 

*  ©return  the  request  type 
*1 

public  int  getRequestType()  { 
return  requestType; 

}  //  end  getRequestTypeO  method 


I** 

*  Gets  the  file  name 

* 

*  ©return  the  file  name 
*1 

public  String  getFile()  { 
return  file; 

}  //  end  getFileO  method 

*  Gets  the  file  hash  value 

* 

*  ©return  the  file  hash  value 
*t 

public  String  getHash()  { 
return  hash; 

}  //  end  getHashO  method 

*  Gets  the  offset 

* 

*  ©return  the  offset 
*1 

public  int  getOffset()  { 
return  offset; 

}  //  end  getOffsetO  method 
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*  Gets  the  packet  size 

* 

*  ©return  the  packet  size 
*/ 

public  int  getPacketSize()  { 
return  packetSize; 

}  //  end  getPacketSizeO  method 

*  Sets  the  request  type 

* 

*  @param  newRequestType  the  request  type 
*/ 

public  void  setRequestType(int  newRequestType)  { 
this.requestType  =  newRequestType; 

}  //  end  setRequestTypeO  method 

*  Sets  the  file  name 

* 

*  @param  newFile  the  file  name 
*/ 

public  void  setFile(String  newFile)  { 
this.file  =  newFile; 

}  //  end  setFileO  method 

*  Sets  the  file  hash  value 

* 

*  @param  newHash  the  file  hash  value 
*1 

public  void  setHash(String  newHash)  { 
this.hash  =  newHash; 

}  //  end  setHashO  method 

*  Sets  the  file  offset 

* 

*  @param  newOffset  the  file  offset 
*/ 

public  void  setOffset(int  newOffset)  { 
this.offset  =  newOffset; 

}  //  end  setOffsetO  method 
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*  Sets  the  file  transfer  packet  size 

* 

*  @param  newPacketSize  the  file  tranfer  packet  size 
*1 

public  void  setPacketSize(int  newPacketSize)  { 
this.packetSize  =  newPacketSize; 

}  //  end  getPacketSizeO  method 

*  Checks  for  equality 

* 

*  @param  request  the  file  request  that  we  want  to  check  the  equality  with 

*  ©return  the  true  if  the  requests  aren  equal,  false  if  they  aren't 
*1 

public  boolean  equals(PFTPFileRequest  request)  { 
boolean  isEqual  =  false; 
if  (this.getFileO  ==  request.getFile()  && 
this.getHashO  ==  request. getHash()  && 
this.getOffsetO  ==  request.getOffset()  && 
this. getPacketSizeO  ==  request.getPacketSizeO)  { 
isEqual  =  true; 

} 

return  isEqual; 

}  //  end  equalsO  method 

}  //  end  EileRequest  class 
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//packages 
import  java.io.*; 
import  java.util.*; 

*  File  AvailableFileMap.java 

* 

*  This  the  class  that  is  used  to  store  the  availiable  to  download 

*  files  in  the  PFTP  server. 

* 

*  ©author  LT  Peri k1  is  Pantoleon 

*  ©version  1.0 
*1 

public  class  AvailableFileMap 
extends  HashMap 
implements  Serializable  { 

/**  The  capacity  of  the  file  map  */ 
private  int  capacity; 

/** 

*  Default  Constructor 
*/ 

public  AvailableFileMapO  { 

superO; 
capacity  =  16; 

}  //end  AvailableFileMap  class  default  constructor 

*  Constructor 

* 

*  ©param  theCapacity  the  file  map  capacity 
*f 

public  AvailableFileMap(int  theCapacity)  { 
superO; 

capacity  =  theCapacity; 

}  //end  AvailableFileMap  class  constructor 

*  Returns  the  file  map  capacity 
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* 

*  ©return  the  file  map  capacity 
*1 

public  int  getCapacityO  { 
return  capacity; 

}  //  end  getCapacityO  method 

*  Sets  the  file  map  capacity 

* 

*  @param  newCapacity  the  new  file  map  capacity 
*/ 

public  void  setCapacity(int  newCapacity)  { 
capacity  =  newCapacity; 

}  //  end  setCapacityO  method 

*  Check  if  there  is  an  entry  with  a  specific  file  name  as  key 

* 

*  @param  fileName  the  string  file  name  key  value 

*  ©return  hasFile  true  if  there  is  an  entry,  false  otherwise 
*1 

public  boolean  hasFile(String  fileName)  { 

boolean  hasFile  =  this.containsKey(fileName); 
return  hasFile; 

}  //  end  hasFileO  method 

*  Returns  the  file  byte  array  that  mas  the  key  file  name 

* 

*  ©param  fileName  the  string  file  name  key  value 

*  ©return  the  file  byte  array  that  mas  the  key  file  name 
*/ 

public  byte[]  getFileBytes(String  fileName)  { 

byte[]  fileBytes  =  (byte[])  this.get(fileName); 
return  fileBytes; 

}  //  end  getFileBytesO  method 
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*  Add  a  file  byte  array  and  assosiates  it  with  a  file  name 

* 

*  @param  fileName  the  file  name  of  the  file  key  value 

*  @param  fileBytes  the  file  bytes  of  the  key  file 
*1 

public  void  addFile(String  fileName,  byte[]  fileBytes)  { 
this.put(fileName,  fileBytes); 

}  //  end  addFileO  method 

*  Removes  a  file  byte  array  that  assosiated  with  a  file  name 

* 

*  @param  fileName  the  file  name  to  remove  from  file  map 
*t 

public  void  removeFile(String  fileName)  { 
this  .remove(fileN  ame) ; 

}  //  end  removeFileO  method 
}  //  end  AvailableFileMap  class 
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//packages 

import  java.awt.Canvas; 
import  java.awt.Image; 
import  java.awt.Graphics; 
import  java.awt.Dimension; 

*  File  PFTPCanvas.java 

* 

*  This  the  class  that  draws  a  Canvas  with  an  image  on  it 

* 

*  ©author  LT  Peri k1  is  Pantoleon 

*  ©version  1.0 
*1 

public  class  PFTPCanvas  extends  Canvas  { 

/**  The  image  on  the  canvas  */ 
private  Image  canvasimage  =  null; 

*  Default  Constructor 
*1 

public  PFTPCanvas(){ 
superO; 

}  //end  PFTPCanvas  class  default  constructor 

/** 

*  Sets  the  image  on  the  canvas 

* 

*  ©param  animage  the  new  image  on  the  canvas 
*1 

public  void  setlmage(  Image  animage  )  { 
canvasimage  =  animage; 

}  //  end  setImageO  method 

*  Returns  the  image  on  the  canvas 

* 

*  ©return  the  image  on  the  canvas 
*/ 

public  Image  getlmage()  { 
return  canvasimage; 

}  //  end  setImageO  method 
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*  Updates  the  image  on  the  canvas 

* 

*  @param  g  the  Graphics  object  of  the  canvas 
*1 

public  void  update(  Graphics  g  )  { 
paint(  g ); 

}  //  end  updateO  method 

/** 

*  Draws  the  image  on  the  canvas 

* 

*  @param  g  the  Graphics  object  of  the  canvas 
*f 

public  void  paint(  Graphics  g  )  { 
if(  canvasimage  !=  null ){ 

Dimension  size  =  getSize(); 
g.clearRect(  0,  0,  size.width,  size.height ); 
g.drawlmage(  canvasimage,  0,  0,  this  ); 

}  //end  if 

}  //  end  paint()  method 
}  //  end  PFTPCanvas  class 
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